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survey,  conducting  the  survey  mil  reporting  on  the  survey  were  included  in  tin 
study. 

The  site  modeling  program  models  the  manufacturing  processes  which  contri- 
bute pollutants  to  the  system,  models  the  sewer  system,  and  models  the  treat- 
ment system  including  acid  or  caustic  neutralization,  settling  ponds,  and 
domestic  treatment.  The  inputs  to  the  model  are  the  production  levels  of  tin 
manufacturing  processes  and  the  outputs  are  the  predicted  pollutant  measuromrn: 
values  at  each  possible  measure  point  in  the  system. 

The  resource  matching  program  accepts  data  defining  proposed  measurements 
and  matches  these  against  the  available  time,  manpower,  and  equipment.  T 1 ic- 
on t p u t lists  the  pollutant  to  he  measured  at  each  measure  point,  the  total 
commitment  of  time  for  each  analyst  and  for  each  piece  of  equipment.  Note  is 
made  of  any  overcommitment  of  manpower  or  equipment. 

The  model  refinement  or  updating  program  accepts  measurements  taken  during 
a preliminary  survey  or  during  a regular  survey  and  computes  suggested  new 
parameters  for  the  process  models. 

The  indicator  model  program  evaluates  the  performance  of  sanitary  treat- 
ment facilities. 

The  program  uses  design  data,  data  from  the  operating  log  and/or  data 
generated  during  the  survey  and  computes  key  operational  characteristics,  re- 
pairing these  with  desirable  values  as  cited  in  design  books  and  manuals  wi i 
give  the  survey  planner  insight  into  the  operation  of  the  system  and  surge.-: 
the  need  for  more  survey  measurements  or  the  need  for  changes  in  operation. 

A system  was  developed  for  automatic  instrumentation  of  pH,  conduc t i ■ i t ■ , 
and  other  parameters  which  use  strip  charp  recordings.  Interface  hardware  w.i 
selected  and  purchased  and  interface  software  was  developed  for  direct  connec- 
tion to  a digital  computer. 

A data  handling  system  was  developed  for  use  during  and  after  the  suiv. 

A PDP8-OS/8  and  peripheral  equipment  was  purchased.  Software  was  developed  : 
perform  data  handling  functions  and  to  direct  the  user  in  application  of  th. 
software.  The  program  accepts  raw  data  from  the  analytical  chemist  .mi  p.  r- 
forms  data  conversions,  transcriptions,  and  data  logging  functions.  'utpet 
is  available  in  several  forms  as  may  be  needed  for  various  reports  dwri: 
at  the  end  of  the  survey. 

Recommendations  are:  the  survey  planner  should  obtain  sufficient  .lit.,  n 

a preliminary  survey  to  model  and  analyze  the  site;  measurements  should  be 
mated  to  the  maximum  extent  possible;  data  handling  should  he  dele gat-"!  t.  ; , 
computer  when  the  operations  ire  well  defined  and  repetitive.  The  progi.i  , 
software  and  hardware  included  here  will  assist  the  survey  planner  in  id.  i 
these  recommendations  and  design  a more  effective  survev. 
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INTRODUCTION 


lntij|3duct  ion: 

A Data  Handling  System  is  described  which  handles  on-site  water 
quality  survey  data  measured  by  the  Army.  Data  and  commands  are  entered 
into  the  system  on-line  via  either  the  Teletype,  Hewl et t-Packard  optical 
mark  reader,  Talos  graphic  digitizer,  DEC  manual  data  entry  station. 

Yellow  Springs  S-C-T  meter,  or  Fisher  pH/ion  meter.  The  digitizer,  manual 
data  entry  station,  specific  conductivity  instrumentation,  and  pH  in- 
strumentation are  interfaced  to  the  system  via  the  DEC  PDP-70  programmable 
data  mover.  The  Data  Handling  System  may  be  at  a fixed  location  with  a 
telephone  data  link  and/or  may  be  found  on-site. 

The  Data  Handling  System  may  be  viewed  as  a collection  of  programs 
which  operate  within  the  supervision  of  the  OS/8  executive  on  a DEC  PDP-S/E. 
Each  of  these  programs  operate  in  conjunction  with  data  files  found  on  the 
mass  storage  devices.  An  important  feature  of  the  OS/8  software  permits 
the  user  of  the  system  to  develop  programs  written  in  BASIC  which  can 
utilize  the  same  data  base  generated  by  the  data  handling  software. 

The  OS/8  is  a software  system  which  is  supported  by  a large  variety 
of  hardware  configurations  with  a DEC  PDP-8/E  CPU.  This  system  is  a com- 
prehensive library  of  system  programs  operating  under  the  supervision  of 
an  integrated  executive.  A brief  description  of  the  OS/8  executive  is 
found  in  the  OS/8  System  Section. 

Data  Formats: 

All  measurements  accepted  by  the  system  must  have  a format  consisting 
of  6 primary  ID  tags,  5 secondary  ID  tags,  and  a measurement  value.  The 
format  of  a measurement  is  as  follows: 


I 


IDI  ID2  103  104 


1 05  I D6  ID7  108  ID9  1010  ID11  Value 


where  the  primary  ID  tags  are: 


IDI  = Day  ID 
I D2  = Point  ID 
ID3  = Period  ID 
104  = Parameter  ID 
I D5  = Disc  rete  I D 
ID6  = Comment  ID 


Each  primary  ID  is  a character  string  from  0 to  6 characters  in  length. 
However,  only  the  Discrete  and  Comment  ID  are  permitted  to  be  null  (0 
characters).  A maximum  of  63  IDs  are  permissible  in  each  primary  ID 
group. 

The  secondary  ID  tags  with  the  usual  assigned  Quality  and  Accuracy 
ID  tags  are: 


I D 7 = Qua  1 i ty  ID 

Turbid  (T) 

Clear  (CL) 

Light  Color  (LC) 

Intense  Color  (1C) 

Hot  (H) 

Cold  (C) 

Greasy  (G) 

Nonhomogeneous  (NH) 
Imperfect  Preservation  (IP) 
Questional  Stability  (QS) 

ID8  = Accuracy  ID 

Accurate  Result  ( AR ) 

10%  (10%) 

Order  of  Magnitude  (0M) 
Inaccurate  Results  (IR) 


I D9  = Chem i s t ID 


11)10  = Method  ID 
I D I I = Unused 

More  than  one  Quality  ID  tag  may  be  used  to  describe  each  measurement  with 
each  Quality  ID  tag  being  a character  string  from  0 to  6 characters.  Up 
to  12  Quality  ID  tags  can  be  handled  with  a comma  separating  multiple 
Quality  ID  tags.  The  Chemist,  Accuracy,  and  Method  ID  tags  are  character 
strings  from  0 to  6 characters  in  length  with  a maximum  of  63  IDs  permis- 
sible in  each  of  these  groups. 

Examples  of  measurements  are  as  follows: 


1 

Cl 

2 

COND  2 

T , LC  , H 

AR  DRAKE  Ml  700 

10 

SI 

3 

PH 

DRAKE 

7.  ** 

2 

IS 

1 

TOC  25 

BROWN 

200 

Overview  of  Data  Handling  Operation : 

A brief  summary  of  the  various  data  handling  operations  follows: 

1.  Data  Input  - Data  and  commands  are  entered  into  the  data  handling 
system  via  either  the  Teletype,  optical  mark  reader,  digitizer,  manual 
data  entry  station,  or  interfaced  automated  instrumentation.  The  system 
will  accept  one  or  more  raw  measurement  values  for  each  measurement  on 
input  and  then  perform  the  appropriate  data  reduction  to  arrive  at  a final 
measurement  value.  This  data  when  received  is  extensively  checked  by  this 
system.  Valid  data  is  transferred  to  a data  file.  Error  messages  are 
generated  for  invalid  data.  A new  data  file  is  created  each  time  the 
system  enters  the  data  input  mode.  The  name  of  this  data  file  is  deter- 
mined by  the  system  while  the  filename  extension  is  specified  by  the 
operator . 
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2.  Merge  - Each  of  the  files  created  during  data  input  must  be 
merged  into  a master  data  file  with  either  the  program  PIP  or  MERGE  by 
the  system  supervisor.  The  program  MERGE  lists  the  name  of  each  data 
file  which  has  not  been  merged  and  receives  a response  from  the  super- 
visor on  the  particular  action  to  be  taken.  Measurements  may  also  be 
e:ther  deleted  or  changed  within  the  master  data  file  with  MERGE. 

3.  Report  - Reports  and  Print-Plots  of  selected  data  in  a variety 
of  formats  can  be  requested  by  the  operator. 

4.  Sort  - Selected  information  is  retrieved  from  a specified  data 
file  and  sorted.  A data  file  is  created  for  this  sorted  data. 

5-  File  Management  - File  management  operations  such  as  the  transfer 
of  files  between  devices,  merge  and  delete  files,  and  list,  zero,  and 
compress  directories  are  provided  by  the  OS/8  system  programs  FOTP,  PIP, 
and  DIRECT. 

6.  Analysis  Functions  - The  analysis  programs  provide  the  capability 
of  computing  parameters  such  as  ralnge,  maximum,  minimum,  mean,  and  standard 
deviation  for  selected  measurements. 

7.  System  Generation  - Several  system  tables  are  used  by  the  system 
to  define  the  particular  survey  to  the  system.  The  extensive  use  of  tables 
permits  the  system  to  be  readily  adapted  to  each  survey. 

8.  Data  Reduction  - Data  reduction  programs  can  be  readily  implemented 
as  OS/8  supports  BASIC,  FORTRAN  II,  and  FORTRAN  IV. 

Operator  Requirements: 

Operation  of  the  system  may  require  knowledge  of  the  following  OS/8 
system  operating  concepts: 

I.  Permanent  Device  Names 
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2.  File  Names  and  Extensions 

3.  Keyboard  Monitor  Commands 

4.  Command  Decoder  Command  Strings 
5-  PIP  Program  Operation 

6.  FOTP  Program  Operation 
7-  DIRECT  Program  Operation 
8.  BATCH  Program  Operation 
9-  OS/8  BASIC  Operation 
10.  Concise  Command  Language  Commands 
Each  of  these  concepts  are  documented  in  the  DEC  OS/8  Handbook. 

The  present  system  supports  two  on-line  DECtape  units.  Each  DECtape 
unit  can  store  up  to  240  files  having  a combined  total  length  of  approxi- 
mately 700  blocks.  A block  when  used  for  data  storage  can  hold  28  measure- 
ments. The  data  handling  software  automatically  defines  a consistent 
set  of  file  names  to  the  various  files  created  during  data  entry.  The 
programs  PIP,  FOTP,  and  DIRECT  are  useful  in  managing  the  files  on  these 
devices . 
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OS/8  SYSTEM  OPERATION 


I ntroduct ion: 

The  OS/8  Operating  System  is  a powerful  programming  system  designed 
for  the  POP-8  family  of  computers.  This  system  permits  use  of  a wide 
range  of  peripherals  and  all  available  core  up  to  32K.  OS/8  offers  a 
versatile  Keyboard  Monitor  which  allows  the  user  to  control  the  flow  of 
programs.  In  addition  to  the  Keyboard  Monitor,  OS/8  offers  extensive  I/O 
facilities  at  the  Monitor  level  which  are  documented  in  the  OS/8  Software 
Support  Manual  (DEC-S8-0SSMB-A-D) . 

Besides  the  Monitor  facilities,  OS/8  includes  a library  of  powerful 
system  programs  which  allows  the  user  to  do  program  development  using 
BASIC,  FORTRAN  II,  FORTRAN  IV,  or  assembly  language.  A detailed  descrip- 
tion of  each  of  these  system  programs  is  found  in  the  0S/8  Handbook  (DEC- 
S8-0SHBA-A-D) . OS/8  BATCH  provides  the  user  of  the  system  with  a batch 
processing  monitor  that  is  integrated  into  the  OS/8  Monitor  structure. 

Starting  the  OS/8: 

The  data  handling  system  has  a TD8E  ROM  Bootstrap.  The  following 
steps  should  be  followed  when  starting  the  system. 

1.  Set  the  switch  register  on  the  PDP-8/E  console  to  7470  (octal), 
i.e.,  set  switches  0,  1,  2,  3.  6,  7,  and  8 in  the  up  position  and  set 
switches  4,  5.  9,  10,  and  II  in  the  down  position. 

2.  Raise  the  SING  STEP  switch.  Lower  and  raise  the  HALT  switch. 

3-  Mount  an  OS/8  system  tape  on  DECtape  unit  0 and  set  to  WRITE  EN- 
ABLE and  REMOTE.  A second  DECtape  may  be  mounted  on  DECtape  unit  1. 

4.  Press  the  EXTD  ADDR  LOAD,  ADDR  LOAD,  CLEAR,  and  CONT  switches. 
The  tape  bootstrap  will  be  executed  and  the  OS/8  Keyboard  Monitor  will 
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print  a dot  (.)  to  indicate  that  it  is  active. 


File  Names  and  Extensions: 

Files  are  referenced  by  a name  of  up  to  six  alphanumeric  characters 
followed,  optionally,  by  a period  and  an  extension  of  two  alphanumeric 
characters.  The  extension  to  a file  name  is  generally  used  as  an  aid  for 
remembering  the  format  of  a file.  Some  system  programs  utilize  default 
extensions  when  an  extension  is  not  specified.  For  example,  the  extension 
. SV  indicates  a core  image  file  while  .BA  indicates  a BASIC  source  file. 

Permanent  Device  Names: 

Each  device  in  the  OS/8  system  is  referenced  by  means  of  a standard 
permanent  dev'  e name.  These  names  are  as  follows: 


Permanent  Name 

1/0  Device 

SYS 

System  device  (DECtape  0) 

DTAO 

DECtape  unit  0 

DTA1 

DEC  tape  unit  1 

DSK 

Default  device  (DECtape  1) 

TTY 

Teletype  keyboard  and  printer 

PTP 

Paper  tape  punch  on  Teletype 

PTR 

Paper  tape  reader  on  Teletype 

MTAO 

Magnetic  tape  unit  0 

MTA1 

Magne t i c tape  unit  1 

CDR 

Card  Reader 

Using  the  Keyboard  Monitor : 

Each  command  to  the  Keyboard  Monitor  is  typed  at  the  Teletype  keyboard 
A command  line  is  terminated  with  a RETURN  or  an  ALTMODE.  Correcting  mis- 
takes is  accomplished  by  typing  the  RUBOUT  key  which  deletes  the  last 
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I 


character  and  causes  a backslash  ( \)  to  be  printed  followed  by  the 
character  which  was  deleted.  Successive  RUBOUTS  each  cause  one  more 
character  to  be  printed  and  deleted.  The  first  non-RUBOUT  causes  a back- 
slash ( \)  to  be  printed  thus  enclosing  the  deleted  characters  with  back- 
slashes. For  example: 


User  types: 
Printer  shows: 
Monitor  sees: 


RUN  DSK: (RO) (RO) (RO) (R0)SYS:ABC 
RUN  DSK:  \ : KSD\SYS  : ABC 
RUN  SYS: ABC 


A command  line  may  be  deleted  completely  by  typing  a CTRL/U.  Control 
can  be  returned  to  the  Keyboard  Monitor  while  running  any  of  the  system 
programs  by  typing  a CTRL/C. 


Keyboard  Monitor  Commands: 

The  user  has  a choice  of  nine  commands  which  he  may  type  in  response 
to  the  dot  (.)  printed  by  the  Keyboard  Monitor.  These  are:  ASSIGN.  DE- 

ASSIGN, GET,  SAVE,  ODT,  RUN,  R,  START,  and  DATE.  Commands  may  be  abbre- 
viated by  typing  only  the  first  two  characters.  The  Keyboard  Monitor 
will  also  accept  CCL  commands. 

The  ASSIGN  command  is  of  the  form: 

.ASSIGN  dev  udev 
or 

.AS  dev  udev 

This  command  causes  a new  user-defined  device  name  (udev)  to  be  considered 
equivalent  to  the  permanent  device  name  (dev).  For  example: 

.AS  DTAI  IN 

cause  all  future  references  to  In  to  refer  to  DECtape  unit  I. 
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The  DEASSIGN  command  is  of  the  form: 


.DEASSIGN 

or 

.DE 

and  causes  all  permanent  device  names  to  be  restored,  discarding  all  pre- 
vious user-defined  device  names. 

The  R command  is  of  the  form: 

. R f i 1 e . ex 
or 

. R file 

This  command  handles  only  core  image  files  from  the  system  device.  The 
file  is  loaded  and  started.  If  the  file  name  extension  is  not  specified, 
the  extension.  SV  is  automatically  added. 

The  RUN  command  is  of  the  form: 

. RUN  dev : f i le . ex 

This  command  handles  only  core  image  files.  The  file  on  the  specified 
device  is  loaded  and  started. 

The  GET,  SAVE,  ODT , and  START  commands  will  not  be  discussed  as  they 
would  not  normally  be  used  by  the  operator. 

The  DATE  command  is  of  the  form: 

.DATE  mm/dd/yy 
or 

.DA  mm/dd/yy 

The  DATE  command  sets  up  the  date  in  the  system  for  purposes  of  datinq 
directory  entries  and  listings,  printing  on  program  output,  etc. 
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Concise  Command  Language  (CCL): 

The  CCL  provides  the  OS/8  user  with  an  extended  set  of  Keyboard 
Monitor  Commands.  Many  CCL  commands  allow  the  user  to  call  a system  pro- 
gram indirectly,  perform  an  operation,  and  return  to  the  Keyboard  Monitor. 
The  CCL  commands  are  entered  at  the  terminal  in  the  same  manner  as  Key- 
board Monitor  commands,  in  response  to  the  dot  (.)  printed. 

Certain  CCL  commands  that  run  the  FOTP  or  DIRECT  programs  may  use  a 
wild  card  construction.  The  wild  card  construction  means  that  the  file 
name  or  the  extension  in  the  CCL  command  may  be  totally  replaced  with  an 
asterisk  (*)  or  partially  with  a question  mark  (?)  to  designate  certain 
file  names  or  extensions. 

Example  of  the  asterisk  are  as  follows: 

DATA.*  All  files  with  name  DATA  and  any  extension 

*.AA  All  files  with  the  extension  AA 

*.*  All  files 

Examples  of  the  question  mark  construction  are  as  follows: 

DATA. A?  All  files  with  name  DATA  and  any  extension 

beg  inning  with  A 

DATA??.??  All  files  with  any  extension  and  the  file  name 
beg  ins  with  DATA 

???.*  All  files  with  file  names  3 characters  or  less 

Some  CCL  commands  of  interest  will  be  discussed  in  the  following 
paragraphs.  Only  a small  subset  of  commands  will  be  presented.  The  OS/8 
Handbook  provides  a complete  description  of  all  the  CCL  commands. 

The  COPY  command  transfers  files  from  one  I/O  device  to  another. 
The  COPY  command  has  the  form: 

.COPY  DEV: FILE.EX<DEV: FI LE.EX 
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The  wild  card  construction  may  be  used  and  each  file  copied  is  listed 
on  the  terminal. 


The  DIR  command  produces  listings  of  OS/8  device  directories.  The 
DIR  command  has  the  form: 

.DIR  DEV: 

The  SUBMIT  command 

SUBMIT  DEV : F I LE . EX 

runs  the  BATCH  program  with  the  commands  given  in  the  specified  file. 
Command  Decoder: 

Many  programs  make  use  of  the  Command  Decoder  by  permitting  the  user 
to  enter  a list  of  I/O  files  and  devices.  The  Command  Decoder  prints  an 
asterisk  (*)  at  the  left  margin  to  indicate  it  is  ready  to  accept  a com- 
mand string.  The  command  string  has  the  general  form: 

Output  files<lnput  files/Options 

where  the  left  angle  bracket  (<)  is  the  divider  character  between  output 
and  input  files.  There  may  be  0-3  output  files  and  0-9  input  files 
specified  in  a command  string. 

Each  file  in  the  command  string  is  specified  by  a device  name,  file- 
name, and  a filename  extension.  The  filename  is  separated  from  the  device 
name  and  extension  respectively  by  a colon  (:)  and  a period  (.).  A comma 
separates  multiple  files  in  the  string.  The  device  DSK:  is  used  whenever 
the  device  is  not  specified. 

Various  options  can  also  be  indicated  within  a command  line.  Options 
are  either  numbers  or  alphanumeric  option  characters.  Numbers  used  as 
options  are  generally  contained  in  the  command  line  with  equal  sign  (=) 
or  square  brackets  ([])  cons t rue t i on . The  alphanumeric  option  characters 

1 1 


are  set  off  from  the  I/O  specifications  by  the  slash  (/)  character  for 
single  character  options,  and  parentheses  for  a string  of  single 
cha  racters . 

Some  examples  of  command  strings  are  as  follows: 

DTA I : DATA . AA<DTA0 : DATA . AB , SYS : ABC . SV/ I /A 
, where  one  output  file  with  device  and  two  input  files  with  input  devices 
are  specified.  The  A and  I options  were  specified. 

I 
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DATA  FILE  NAMING  CONVENTIONS 


Data  Files: 

The  data  handling  software  by  default  has  selected  a consistent  set 
of  data  file  names.  The  file  name  is  changed  by  the  data  handling  soft- 
ware whenever  the  measurement  data  within  the  file  has  been  used  to  up- 
date a master  data  file.  This  file  name  thus  reflects  the  status  of  the 
file  with  respect  to  a master  data  file. 

A new  data  file  is  created  each  time  the  system  enters  the  data 
entry  step.  The  data  entry  program  INPUT  creates  files  with  the  following 
file  names : 

D1XXYV.ZZ  Add  data  fi  le 

D2XXYY.ZZ  Change  data  file 

D3XXYY.ZZ  Delection  data  file 

where 

XX  = First  2 characters  in  chemist  name 

YY  = Internal  Parameter  ID 

ZZ  = Extension  specified  by  chemist. 

Hence,  each  data  file  is  uniquely  defined  in  terms  of  the  chemist,  para- 
meter, and  its  usage  within  the  system.  The  initial  file  should  be  given 
an  extension  of 

Initial  Extension  = 01 

and  incremented  each  time  a new  data  file  is  entered  into  the  system 
with  the  same  file  name. 

The  master  data  file  may  reside  on  any  mass  storage  device  and  has 
the  file  name  of 

MASTER. ZZ 
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The  first  master  data  file  would  be  given  the  extension  of  01  and  in- 
cremented each  time  a new  master  file  is  created. 

The  first  letter  of  a file  name  is  changed  to  the  letter  A whenever 
this  file  has  been  used  to  update  the  master  data  file.  These  data  files 
become 

AIXXVY.ZZ 
A2XXYY.ZZ 
A3XXYY.ZZ 
AASTER. XX 

after  they  have  been  used  to  update  a master  data  file. 

Temporary  Data  Files: 

The  following  file  names  are  used  by  the  system  for  temporary  data 
storage  and  should  never  be  used  for  permanent  data  storage. 

DATA.*  Created  by  Sort 

DATADD.*  Created  by  Sort 


FILE  MANAGEMENT 


The  OS/8  system  programs  PIP,  FOTP,  and  DIRECT  provide  the  user  with 
several  file  management  operations.  These  file  management  operations  in- 
clude the  transfer  of  files  between  devices,  merging  and  deleting  files, 
and  list,  zero,  and  compress  directories.  The  OS/8  Handbook  gives  a com- 
plete description  of  these  system  programs. 


PIP: 

PIP  is  an  OS/8  system  program  which  is  used  to  transfer  files  between 
devices,  merge  and  delete  files,  and  list,  zero,  and  compress  directories. 
PIP  is  called  by  the  command 
.R  PIP 

in  response  to  a dot  printed  by  the  Keyboard  Monitor.  PIP  uses  the  Com- 
mand Decoder  to  receive  all  I/O  file  specifications  and  options  from  the 
user.  the  /I  option  must  be  used  with  all  file  transfers.  Four  examples 
showing  PIP  operations  are  now  shown. 

PIP  Example  1 (Merge) 

.R  PIP 

*SYS : DATA.  23<  INPUT.  1*8,  INPUT.  A9,  INPUT.  50/ 1 
This  command  instructs  PIP  to  merge  the  files  INPUT. 1*8,  INPUT. 49  and 
INPUT. 50  on  DSK  into  one  file  DATA. 23  on  SYS.  The  /I  option  must  be 
used  for  this  operation. 

PIP  Example  2 (File  Deletion) 

*DATA.AB</D 
*DATA: DATA. AC</D 

The  files  DATA.AB  and  DATA. AC  are  deleted  respectively  from  DSK  and 
DATA. 
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FOTP : 

FOTP  is  an  OS/8  system  program  which  is  used  to  transfer  files  between 
devices,  deleted  files,  and  rename  files.  FOTP  is  faster  than  PIP  for 
certain  functions  and  can  perform  certain  functions  not  available  to  PIP. 
One  advantage  of  FOTP  is  that  it  permits  a wild  card  construction  in  the 
command  string.  The  wild  card  construction  allows  several  files  to  be 
transferred,  deleted,  or  renamed  with  a single  command.  The  same  PIP 
function  might  require  several  commands  to  arrive  at  the  same  result. 
Examples  of  FOTP  use  after  being  loaded  by 
.R  FOTP 

are 

*DSK: DATA. ??/D  Deleted  all  file  on  DSK:  with 

the  name  of  DATA 

"DTA 1 : <DTAO : DAT A . " Transfer  all  files  on  DTAO:  to 

DTAI:  with  name  of  DATA 
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DIRECT: 


I 

I 

I 

I 


DIRECT  is  an  OS/8  system  program  that  produces  listings  of  OS/8 
directories.  DIRECT  producrs  several  varieties  of  listings  and  supports 
the  wild  card  construction  in  the  command  line.  PIP  also  produces  direc- 
tory 1 i st  i ngs . 

Examples  of  DIRECT  use  after  being  loaded  by 
. R DIRECT 


are 

*DSK: D1 ????. * List  all  files  beginning  with  D1  on 

the  Teletype 

*SYS : A2???? . 03  List  all  files  beginning  with  A2  with 

an  extension  of  03  on  the  Teletype 
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DATA  ENTRY 


Data  is  entered  into  the  system  via  either  the  Hewlett-Packard 
HP-7260A  Optical  Mark  Reader  or  the  Teletype.  The  program  INPUT  is  used 
for  this  purpose  and  is  loaded  as  follows: 

.AS  DSK  DATA 
.R  INPUT 


The  device  DATA  must  have  been  defined  to  OS/8  prior  to  loading  INPUT. 

Each  command  line  received  by  INPUT  must  have  the  following  format: 


where 


CMD 

ID1 

ID2  ID3  IDA  IDIO  ID5  ID 

CMD 

= 

Command  Code 

ID1 

= 

Day  ID 

1D2 

= 

Point  ID 

103 

= 

Period  ID 

IDA 

= 

Parameter  ID 

1 DIO 

= 

Method  ID 

ID5 

= 

Discrete  ID 

107 

= 

Qua) i ty  ID 

ID8 

= 

Accuracy  ID 

1 D6 

= 

Comment  ID 

VI 

= 

First  measurement  value 

V 2 

= 

Second  measurement  value 

Vn 

- 

Nth  measurement  value 
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Each  command  line  is  classified  as  a command  or  a measurement  to  the  system 
by  the  command  code  with  a null  command  code  specifying  a measurement. 

The  following  notation  is  used  to  simplify  the  command  line  examples 
which  fol low. 

ID  = Va I id  set  of  I Ds 

PAR  = Valid  Parameter  and  Method  ID  only 
VAL  = N measurement  values  VI,  V2,  . . . , Vn 

J = One  or  two  digit  positive  integer  in  numeric  field 
K = One  or  two  digit  positive  integer  in  numeric  field 

Data  File  Specification: 

The  data  file  created  by  the  data  entry  step  must  be  specified  before 
this  program  will  accept  measurements.  These  data  files  are  normally 
given  one  of  the  following  names : 

DATA : D1 XXYY . ZZ  Add  Data  File 

DATA : D2XXVY . ZZ  Change  Data  File 

DATA : D3XXYY. ZZ  Deletion  Data  File 

where 

XX  = First  2 characters  of  chemists  name 

YY  = Internal  Parameter  ID 

ZZ  = Extension  specified  by  chemist. 


Five  commands  are  provided  for  file  name  specification  which  are 
as  fol lows : 

FNAM  PAR  J K Add  Data  File 

DFILE  PAR  J K Deletion  Data  File 

'9 





CFILE 

PAR  J 

K 

Change  Data  File 

CMDCR 

Call  Command  Decoder 

RFNAM 

PAR  J 

K 

Resubmi t Data  File 

where 

J = Integer  gives  internal  Chemist  ID 
K = Integer  give  file  extension. 

Prior  to  opening  this  file,  the  software  checks  to  see  whether  a file  with 
this  name  is  already  present.  If  a file  is  present,  an  error  message  is 
printed  thus  permitting  the  user  to  change  file  names.  The  RFNAM  command 
permits  the  current  file  with  this  name  to  be  replaced  with  the  data  which 
to  I lows. 

The  software  also  checks  to  see  whether  a file  with  this  name,  but 
with  the  first  letter  being  A instead  of  D,  is  already  present.  If  a file 
is  present,  an  error  message  is  printed  thus  permitting  the  user  to  change 
file  names.  The  check  of  file  names  prohibits  the  user  from  accidently 
deleting  a valid  data  file. 

Chemist  Specification: 

The  name  of  the  chemist  must  be  specified  before  any  measurement  data 
is  accepted  by  the  system.  The  commands  relating  to  the  chemist  specifi- 
cation are  as  follows: 

NACHEM  K Name  the  chemist 

PRCHEM  Print  the  name  of  current  chemist 

The  integer  K appears  in  the  numeric  field  and  is  the  internal  Chemist 
ID  for  this  chemist. 
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End  of  Data  Entry: 


The  command 
END 

tells  INPUT  that  the  end  of  all  input  has  been  received. 

Measurement  Value  Format: 

The  format  of  the  measurements  in  the  numeric  field  can  be  specified 

to  detect  the  presence  of  excessive  digits  or  the  absence  of  missing 

digits.  These  format  commands  are  as  follows: 

FORM  VAL  Enable  format  checking,  sample  measurements 

are  given  in  numeric  field 

OFFORM  Disable  format  checking 

ONFORM  Enable  format  checking 

Two  measurements  have  the  same  format  if  they  have  exactly  the  same  number 

of  digits  before  and  after  the  decimal  points.  Formats  are  checked  only 

on  measurements. 

Default  ID  Generation: 

The  default  IF  option,  when  enabled,  replaces  a missing  ID  with  a 
default  ID.  This  option  is  operable  only  with  measurements  and  not  com- 
mand. The  default  ID  commands  are  as  follows: 

Enable  system  to  use  the  default  ID  set  given 
in  this  command 

Enable  system  to  use  default  IDs 

Disable  system  from  using  default  IDs 

Use  IDs  from  last  measurement  as  the  default 
IDs  and  enable  system  for  default  ID  usage 


GDFID  ID 

ONDID 
OFFDID 
LSD  I D 
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Data  Input  Options: 


Several  options  are  available  to  the  user  to  use  during  data  entry. 
These  options  are  as  follows: 

CONDAT  Accept  only  continuous  data 

DISCAT  Accept  only  discrete  data 

CONERR  Continue  reading  cards  on  an  error 

TRAN  Use  translation  table  (Card  reader  is  usually 

input  device) 

NTRAN  Do  not  translate  (Teletype  usually  is  the 

input  device) 

MXVAL  PAR  VI  Place  maximum  limit  of  VI  on  measurement 
value  for  parameter  given 

MNVAL  PAR  VI  Place  lower  limit  of  VI  on  the  measurement 
value  for  the  parameter  given 

ON  Enable  system  to  do  data  conversions 

OF  Disable  system  from  performing  data  conversions 

Whenever  the  value  of  the  measurement  for  the  specified  parameter  exceeds 
the  specified  limits,  the  value  of  the  measurement  becomes  the  limit  and 
the  comment  ID  is  changed  to  note  that  a limit  has  been  exceeded.  The 
program  INPUT  has  been  initiated  to  accept  both  continuous  and  discrete 
data,  stop  when  an  error  is  encountered  while  reading  cards,  use  transla- 
tion tables,  disable  from  doing  data  conversions,  and  have  no  limits 
spec i f i ed  . 
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coordinate  pairs,  (X.,Y  ),  (X_,Y  ) , .....  (X  ,Y  ),  the  system  defines 

II  l l n n 

the  linear  function  F(x)  as  follows: 


F (X ) = Y.  + Mj  (X  - X.) 


x<x  X.^XSX.  , X-X„  , 
2 i i+l  n- I 


"i  ■ <Vl  - Yi)/(Xi*S  - *•,> 


The  following  command  sequence  is  used  to  enter  these  coordinate  pairs: 


CNI 

OA 

DA 

DA 

DA 

EDA 


PAR 

XI  Y I 
X2  Y2 
X3  Y3 

XN  YN 


I nput  (Xj  , y | ' 


Input  (x  ,y  ) 
End-of- tab  I e 


The  coordinates  which  define  any  function  can  be  listed  by  the  follow- 
ing command: 

LSFNC  PAR 

The  value  of  the  function  can  be  determined  for  any  value  of  X by  the 
following  command: 

CHK.FN  PAR  X 

The  capability  to  define  upper  and  lower  limits  for  this  function 
computations  are  provided  by  the  commands  as  follows: 

MN  PAR  VI 


MX 


PAR 


VI 


VI  is  lower  limit  of  function 
for  given  parameter 

VI  is  upper  limit  of  function 
for  the  given  parameter 


Whenever  the  limits  of  the  function  are  exceeded,  the  comment  ID  is 
changed  to  note  that  the  limit  has  been  exceeded. 
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Calibration  Curve  Computations: 

The  system  program  INPUT  has  the  capability  of  accepting  a sequence  of 

coordinates  (X.,Y  ) and  provide  a least  square  fit  to  this  coordinate 
I » 

sequence  to  find  the  coefficients  for  one  of  the  following  equations: 


Y = M-X 

Y = B + M-X 

Y = B + M • Log (X) 

The  coefficient  for  the  first  equation  is  computed  by  the  command 


sequence : 


LOFNC  PAR 
DA  X]  Yt 


DA  X Y 

EDA  n n 


The  system  will  then  automatically  print  out  the  original  coordinate  sequence 
along  with  the  computed  value  of  Y. 


X,  Yj  **  F (X 1 ) 


X Y **  F (X  ) 
n n n 

The  coefficients,  B and  M,  for  the  second  linear  equation  are  computed 
by  the  command  sequence: 

L1FNC  PAR 
DA  X|  Y 


X Y 
n n 


with  the  program  automatically  printing  out  the  original  sequence  of  points 


m t h the  corresponding  computed  value  of  Y. . 


2A 


m 


The  coefficients  for  the  log-linear  function  are  determined  by  using 
the  command 

LGFNC  PAR 

followed  by  the  sequence  of  coordinate  pairs. 

The  tabulation  of  the  original  coordinate  sequence  along  with  the 
computed  value  of  the  function  can  be  disabled  with  the  command 
DPRFNC 

and  enabled  by 

DPRFNC 

The  system  is  initialized  to  print  this  function. 

The  computed  coefficients  are  automatically  placed  in  the  function 
tables  allocated  to  these  parameters.  The  command 
L5FNC  PAR 

permits  a listing  of  these  tables.  If  the  function  tables  for  this  para- 
meter were  input  by  one  of  these  commands,  the  following  would  be  printed 
in  response  to  this  command. 
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For  the  log-linear  case,  the  coefficients  are 

Y I = B 
V2  = M 

with  the  values  of  Xj  and  having  no  meaning. 

Data  Conversion  Constants: 

The  data  reduction  algorithms  in  some  cases  require  one  or  more  con- 
stants to  fully  define  these  algorithms.  These  constants  are  entered  into 
this  program  by  the  command 

CN  PAR  VAL 
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where  the  number  of  values  entered  is  dependent  on  the  algorithm  for 
the  specified  parameter. 


Dupl icate  Data: 

Under  certain  c i rcums tances , a given  measurment  is  performed  several 
times  with  the  final  measurement  being  the  average  of  all  these  measurements. 
The  program  provides  the  capability  to  accept  multiple  measurements  and 
perform  this  average.  These  duplicate  measurement  must  be  entered  in  con- 
secutive order  with  the  command  sequence 

ID  VAL 

DU  PAR  VAL 

DU  PAR  VAL 

ID  VAL 

The  command  DU  instructs  this  program  that  this  command  line  is  duplicate 
data  for  the  previous  measurement.  When  the  program  encountera  a measure- 
ment for  a new  sample,  the  number  of  measurements  received  and  the  average 
of  these  measurements  are  printed. 

Data  Continuation: 

The  program  provides  the  capability  of  using  more  than  one  card  to 
enter  the  numeric  field  information.  The  command 
ADATA 

enables  the  continuation  of  the  numeric  field  to  additional  cards  while 
NOADA 

requires  all  information  to  be  found  on  one  card.  The  program  is  initial i2cd 
to  require  a command  line  to  be  one  card. 

When  data  continuation  is  used,  the  following  command 
CMD  ID  VI  V 2 V3  VN 

can  be  entered  by 
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CMD 

ID 

VI 

DA 

V 2 

DA 

VN 

Whenever  an  insufficient  number  of  values  are  found  in  the  numeric  field, 
the  program  with  data  continuation  enabled  expects  to  find  the  next  card 
to  have  the  command  DA  with  more  values. 

Skip  ID  Opt  ion: 

Each  command  line  requires  the  specification  of  6 primary  ID  tags  and 
3 secondary  ID  tags.  When  the  Teletype  is  used  as  the  input  device,  this 
specification  requires  excessive  typing.  This  command  allows  measurement 
command  lines  to  skip  selected  ID  tags  and  use  the  default  ID  option  for 
the  specification  of  these  skipped  ID  tags. 

The  command 

SKPID  ID 

instructs  the  system  to  skip  those  ID  tags  on  input  for  measurement  lines 
for  those  non-null  ID  tags  found  in  this  ID  specification.  If  an  ID  tag 
is  null  in  this  command,  the  user  must  supply  this  ID  via  the  Teletype 
keyboard  for  each  measurement  line.  Command  lines  with  a non-null  command 
code  always  require  the  entering  of  all  information. 

List  Output  Buffer: 

Valid  measurements  are  placed  in  an  output  buffer.  This  output  buffer 
has  space  for  28  measurements.  When  this  buffer  becomes  full,  this  buffer 
is  emptied  by  transferring  these  measurements  to  the  output  device.  The 
command 

LBUF 

permits  the  information  in  the  current  output  buffer  to  be  listed  on  the 
Tel etype . 
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Teletype  Input: 


On  teletype  input,  the  NTRAN  option  should  be  used  to  disable 
translation.  The  program  INPUT  prints  a (0)  to  request  either  a 
measurement  or  a command  line  from  the  operator  while  in  this  mode. 

For  command  lines,  INPUT  automatically  skips  those  ID  tags  which  are 
not  required  to  specify  the  command.  For  measurement  lines,  the  SKPID 
and  DEFID  data  input  options  should  be  used  to  simplify  input.  The 
Automated  Instrument  User's  Manual  gives  example  and  additional  in- 
formation on  receiving  input  from  the  Teletype. 

PDM-70  Programming: 

The  program  INPUT  has  the  capability  of  remotely  programming  an 
interfaced  PDM-70.  The  command  PROG  I sends  program  number  I to  the 
PDM-70.  Programs  1,  2,  and  3 respectively  program  the  PDM-70  to  operate 
the  Fisher  Scientific  pH  meter,  Talos  digitizer,  and  the  Yellow  Springs 
S-C-T  meter.  The  Automated  Instrument  User's  Manual  provided  additional 
details  of  this  function. 

Change  Column  Translate  Table: 

The  command  CHTRAN  I J replaces  the  column  I table  with  the  column 
J table  at  execution  time.  This  command  was  primarily  added  to  permit 
column  0-39  tables  for  a 40  column  card  to  be  replaced  with  tables 
defined  for  columns  40,  41,  42,  . . . 


28 


Translation  Tables: 


When  the  mark  cards  are  used  as  the  input  media,  it  is  necessary  to 
convert  these  marks  to  meaningful  input  through  the  use  of  translation 
tables.  Each  character  from  the  card  reader  when  received  is  translated 
via  a translation  table  to  a character  string  which  may  be  null.  A unique 
translation  table  is  provided  for  each  card  column. 

The  translated  card  image  is  a character  string  which  is  divided  into 
several  character  strings,  called  fields,  by  the  occurrence  of  a space. 

The  character  string  which  defines  each  field  is  translated  into  a new 
character  string  by  a unique  translation  table  provided  for  each  field. 
This  final  resulting  character  string  is  the  character  string  printed  on 
the  Teletype  and  is  interpreted  by  the  system  as  the  command  line.  Each 
field  in  this  final  command  line  is  either  a command  code,  an  ID  tag,  or 
a value  in  the  numeric  field.  The  character  string  for  each  field  is 
checked  for  validity.  The  ID  tags  are  compared  to  the  lists  provided  by 
the  f i le  DSK: SYSDEF.AR. 

Operation  of  Program: 

The  progran  INPUT  is  loaded  by 
.R  INPUT 

with  the  default  options  being 

I.  Input  data  from  the  card  reader 

2.  Accept  continuous  and  discrete  data 
3-  Numeric  formats  are  not  checked 

4.  Card  reader  stops  on  error.  Ready  required  to  restart. 

5.  Default  ID  option  disabled 

6.  Data  continuation  disabled 
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All  output  printed  on  the  Teletype  during  data  entry  is  a copy  of  the 
actual  measurement  information  received  by  the  INPUT  program.  This  print- 
out should  be  reviewed  by  the  chemist  to  validate  that  the  system  received 


the  correct  information.  The  program  MERGE  can  be  used  to  correct  any 
errors  which  are  noted  within  this  file. 

If  the  command  decoder  is  used  to  receive  the  output  file  name,  the 
options  which  may  be  used  are  shown  in  the  Data  Input  Option  Table. 

The  panel  controls  for  the  HP-7260A  are  found  in  tables  showing  both 
Front  Panel  and  Back  Panel  Operator  Controls. 

Back  Panel  Operator  Controls 


Control 

Pos i t ion 

Data  Rate  Selector 

110  Baud 

Card  Selector 

Clock  After  Data 
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Data  Input  Option  Table 


Opt  ion 

Funct ion 

/T 

Input  Data  from  the  Teletype 

/C 

Accept  Continuous  Data  only 

/C 

Accept  Discrete  Data  only 

/E 

Continue  on  Error  Condition 

/F 

Check  Numeric  Field  Formats 
Table) 

(Requ i res  Format 

A 

Front  Panel  Operator  Controls 

Control 

Pos i t ion 

Func  t i on 

Line  on  PB 

1 n 

1 

Turns  Power  On  and  Off 

Terminal  Mute  PB 

1 n 

Mutes  Transmission  from 
Connected  Terminal 

Line/Local  PB 

1 n 

Connects  Reader  for  On-Line 
Ope  rat  ion 

Ful 1/Half  PB 

1 n 

Full  or  Half  Duplex  Operation 

Ready  PB 

Signals  CRB  that  Cards  can  be 
read 

Stop  PB 

Stops  Reading  of  Cards 

Single-Pick  PB 

Not  used  by  CRB 

Continuous-Pick  PB 

Should  not  be  used 
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Several  messages  may  be  printed  on  the  Teletype  regarding  the  status 
of  the  Card  Reader.  These  messages  and  their  functions  are  shown  in  the 


following  table. 


Card  Reader  Status  Messages 


Messages 

Funct i on 

RDY 

Card  Reader  is  ready,  RCADV  PP  was  pressed 

NOT  RDY 

Reader  stopped,  STOP  PB  was  pressed 

HOPPERS? 

Input/Output  Hopper  is  Empty/Full 

i 

PICK  FAIL 

Card  Jam 

COL  CNT 

Excessive  number  of  columns  found  on  a card. 

CONFUSED 

Illegal  character  sequence  detected. 

The  system  reports  to  the  operator  errors  in  the  command  lines  which 
have  been  located.  The  error  message  consists  of  a character  denoting  the 
type  of  error  followed  by  a 2 digit  number  indicating  the  approximate 
column  where  the  error  was  detected.  These  error  codes  are  as  follows: 

Error  Messages 


Code 

Reason 

Bnn 

No  room  in  tables 

Dnn 

Dispatch  error,  no  EDA  command  found 

Enn 

Error  encountered , usua 1 1 y given 
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Code 


Reason 


Fnn 

Format  error  in  numeric  field 

Gnn 

Function  error,  no  information  on  function 

Hnn 

Duplicate  data  error 

1 nn 

ID  error,  illegal  or  missing  ID 

Jnn 

Incorrect  number  of  values  in  numeric 

field 

Knn 

Illegal  Chemist  given 

Lnn 

More  IDs  received  than  expected 

Mnn 

Expected  1 or  2 digit  integer 

Nnn 

File  present  with  same  name  or  illegal 

file 

Pnn 

Device  DATA:  not  found,  fatal  error 

Qnn 

No  table  for  this  parameter 

Rnn 

System  cannot  receive  coordinates 

Snn 

Not  enough  coordinates  given 

Tnn 

Translate  rror 

Vnn 

Cannot  perform  conversion 

Znn 

Command  line  is  too  short 

On  Teletype  input,  the  system  prints  a P to  request  a measurement  from 
the  operator.  The  following  rules  must  be  followed  while  typing  the  measurement. 

1.  One  space  between  each  ID 

2.  One  space  between  comment  ID  and  numeric  field 

3.  Numeric  field  must  be  terminated  with  a RETURN. 

A.  One  space  between  command  field  and  Day  ID. 
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INPUT  COMMAND  SUMMARY 


Card 

Code 

Command 

Funct ion 

DA 

DA 

Data  Card 

EN 

EDA 

End  of  data 

A 1 

GDFID  ID 

Enter  default  ID,  enable  default  ID  option 

A2 

ONDI  D 

Enable  default  ID  option 

A3 

OFFDID 

Disable  default  ID  option 

AA 

LSD  1 D 

Get  default  ID  from  last  measurement 

A5 

SKPID  ID 

Sk i p the  1 Ds  given 

A10 

FORM  VAL 

Enable  numeric  field  format  checking,  the 
numeric  field  must  have  same  format  as  VAL 

A1 1 

ONFORM 

Enable  numeric  field  format  checking 

A12 

OFFORM 

Disable  numeric  field  format  checking 

B 1 

CONDAT 

Accept  continuous  data  only 

B2 

DISDAT 

Accept  discrete  data  only 

B3 

CONERR 

Continue  on  error  option 

BA 

ADATA 

Permit  numeric  field  to  be  continued 
in  the  next  command  lines 

B5 

NOADA 

Disable  numeric  field  continuation 

B6 

S 

NTRAN 

Do  not  translate,  Teletype  is  input  device 

B7 

TRAN 

Translate,  card  reader  is  input  device 

CAI 

LOFNC  PAR 

Using  least  squares,  pass  equation  Y=MX 
through  following  data 

CA2 

LIFNC  PAR 

Using  least  squares,  pass  equation 
Y=B+MX  through  the  following  data 

CA3 

LGFNC  PAR 

Using  least  squares,  pass  the  equation 
Y=B+M'L0G(X)  through  the  following  data 

CAIC 

EPRFNC 

Evaluate  equation  found  by  least  squares 
for  each  X and  print  Y 

Card 


Code 

Command 

Funct i on 

CA1  1 

DPRFNC 

Disable  system  from  evaluating  equation 
after  least  square  fit 

CN 

CN  PAR  VAL 

Enter  constants  for  data  conversion 
a 1 gor i thm 

CN1 

CNI  PAR 

Enable  system  to  accept  the  following 
function  defining  coordinates 

CN2 

LSFNC  PAR 

List  the  function  defining  coordinates 

CN3 

LBUF 

List  current  output  buffer 

CNA 

CHCAL  PAR 

VAL 

Check  data  conversion  algorithm 

CN5 

CHKFN  PAR 

VAL 

Evaluate  function 

CN  1 0 

MN  PAR  VAL 

Accept  function  lower  limit 

CNI  1 

MX  PAR  VAL 

Accept  function  upper  limit 

CN20 

MXVAL  PAR 

VAL 

Limit  maximum  final  measurement  value 

CN2  1 

MNVAL  PAR 

VAL 

Limit  minimum  final  measurement  value 

D 

FNAM  PAR  1 

J 

Specify  data  addition  file  name 

D1  1 

RFNAM  PAR 

1 J 

Name  the  replacement  data  file 

01 

CFILE  PAR 

1 J 

Name  the  change  data  file 

D2 

OFILE  PAR 

1 J 

Name  the  deletion  data  file 

020 

CMOCR 

Call  the  command  Decoder 

CH 

NACHEM  1 

Name  the  chemist 

CHI 

PRCHEM 

Print  the  name  of  chemist 

OF 

OF 

Disable  system  to  do  data  conversions 

ON 

ON 

Enable  system  to  do  data  conversic  r- 

cu 

CU  PAR  VAL 

Enter  duplicate  data 

EN1 

END 

End  of  data  entry 

B8 

CHTRAN  i J 

Replace  column  1 table  with  column  J tab 

B9 

PROG  1 

Send  proqram  1 to  PPM-7D 
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Several  examples  of  data  entry  using  the  program  INPUT  are  shown 
to  illustrate  these  data  entry  commands  with  a wide  variation  of  para- 


meters and  conditions.  These  examples  utilized  the  data  conversion 
algorithms  shown  in  the  following  tables. 


Parameter  Conversion  Algorithm 


SOA 

10 

PH 

IL 

COND 

15 

ACID 

12 

TALK 

1 

G&O 

9 

TURB 

8 

TS 

13 

SS 

9 

MBAS 

6 

NH3-N 

7 

TOC 


2 


i Function 
Number 

0 

1 

2 

3 

A 

5 

6 

i 7 
8 
9 

10 

11 

i 

12 

i 

13 
1 A 
15 


DATA  REDUCTION  ALGORITHMS 
A I gor i thm 

Y = Mj 

Y = 50000  * C3  * (M  3/M2 ) 

Y = F j (M  ])  * M2  + F2(M3)  * Mi, 

Y = F(Mj) 

Y = F ( M 1 ) * M2 

Y = Ci  * Exp  ( C 2 M ]) 

Y = F (M ! ) /M2 

Y = Exp((M,  - Y ! ) / Y 2 ) 

Y = Mj  * M2 

Y = 100  * (M2  - M3 ) /M  j 

Y = F (M  - Cj) 

Y = M3  * F(M2)  * M3 

Y = (M j - M2)  * Cj  * 50000/M 3 

Y = (M3  - M2)  * 1 00/C  i 

Y = Ml/1000 

Y = F](M2)  * F2(Mj 
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FN  AM  TURB 

NACHEM 

ON 

3 1 

3 VOLLA 

1 2 

S 1 1 TURB 

2 1 

* 

+ 2.00 

12 

I 6 1 TURB 

66  1 

* 

+ 66.  00 

12 

I 7 1 TURB 

12  1 

* 

+12.00 

12 

110  1 TURB 

26 

1 * 

+26.00 

12 

113  1 TURB 

5 1 

♦ 

+ 5.00 

1 2 

c j 2 TURB 

8 1 

* 

+ 8.00 

1 2 

I 5 1 TURB 

6 I 

* 

+ 6.00 

1 2 

16  2 TURB 

72  4 

* 

+283.00 

12 

I 7 2 TUBE 

4 1 

★ 

+ 4.00 

1 2 

13  2 TUP.B 

2 1 

* 

+ 2.00 

12 

110  2 TUP.B 

1 5 

i * 

+15.00 

1 2 

111  2 TURB 

1 1 

* 

+ 1.00 

1 2 

1122  TURB 

31 

l * 

+31.00 

1 2 
END 

1132  TURB 

1 5 

l * 

+ 1 5.00 

Figure  1 Sample  Input  and  Computation  for  Turbidity 
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FNAM 

P0  4 

02  02 

MWVAL 

P0  4 

.05 

LI  PNC 

PO  4 

DA 

0 

- . 00162685 

DA 

1 

. 020 

EDA 

+ 

2. 

00 

+ 0 • 

00 

-0.00  * * 

-0.00 

+ 1 . 

00 

+0. C2  ** 

+ 0.02 

ON 

MACH  EM 

02  BP.OVN 

6 19 

1 

PO  4 

16  25  * 

+ 3.6  1 

7 S2 

1 

PO  4 

5.51* 

+ 0.12 

7 S4 

1 

PO  4 

26  1 * 

+ 0.  56 

7 19 

1 

PO  4 

47.  5 1 

♦ 

+ 1.03 

7 I 7 

1 

PO  4 

18.5  5 

* 

+ 1.99 

7 15 

1 

PO  4 

0 25  *< 

+ 0.05 

7 18 

1 

PO  4 

14  625 

* 

+188.22 

7 52 

O 

c 

PO  4 

0 5 ■*< 

+ 3.05 

7 54 

2 

PO  4 

68.2  1 

★ 

+ 1.47 

7 I 7 

2 

PO  4 

24.  5 5 

* 

+ 2.  64 

7 15 

p 

PO  4 

8.8  25 

* 

+ 4.  72 

7 18 

o 

P04 

85  25  * 

+45.92 

:jj  d 


Figure  2 Sample  Input  and  Computation  for  Phosphates 
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fnam  talk 

MACH  EM 
CM  TALK 
ON 


5 2 

5 SMITH 
.0307 


1 3 

S2 

I 

TALK 

T t 

Ac 

4. 

5 1 00 

* 

+69.07 

1 3 

S4 

1 

TALK 

CL/ 

C/ 

AP 

4. 6 

100 

* 

+70.61 

1 3 

I 5 

1 

TALK 

LC/ 

0/ 

AF 

20.4 

1 00 

* 

+ 313.  14 

1 3 

S2 

1 

talk 

I C/ 

C/ 

10 

4. 2 

100 

* 

+64.47 

1 3 

I 6 

2 

TALK 

LC/ 

C/  MH/ 

10  10.5 

C/7 

.J 

+ +322* 

1 3 

19 

/"\ 

C. 

TALK 

CL/ 

C/ 

AP 

1 • 5 

50  * 

+46.05 

l 3 

I 7 

TALK 

CL/ 

C/ 

2 

. 5 50 

* 

+ 76.75 

1 3 

I 5 

2 

TALK 

CL/ 

C/ 

AF 

12.  7 

100 

* 

+194.94 

1 3 

S4 

o 

TALK 

CL/ 

C/ 

AP 

3.6 

1 00 

4c 

+55. 26 

1 3 

S2 

2 

TALK 

CL/ 

C/ 

AF 

4.0 

1 00 

★ 

+61.40 

1 3 

SI 

n 

c. . 

TALK 

LC/ 

Cz 

AP 

3.  7 

100 

★ 

+56. 79 

1 3 

I 1 1 

2 tali: 

CL 

/ C/ 

AP 

2.  7 

50 

* 

+82.89 

1 3 

I 1 0 

2 TALK 

CL 

/ C/ 

AP 

7.2 

10 

it 

+ 1 105.20 

1 3 

IE 

2 

TALK 

LC/ 

H/ 

1 

. 0 50 

+ 30.  70 

Figure  3 Sample  Input  and  Computation  for  Total  Alkalinity 


1*0 


FN  AM 

.MACH  EM 

OM 

A SA  1 
A III  ; 
A SA  2 
A 111 
A 18  2 
A I 7 2 
A 16  2 
A SI  2 
A 16  1 
A £2  1 
A IS  1 
A 110 
A 110 
A I 7 1 
A I 1 3 
A 112 
A SI  1 
A I 1 3 
A S2  2 
A 112 


SS  02  02 

0 2 BKO  VN 


SS 

200 

183670 

1 8666  1 * 

+ 1 03 A. 50 

SS 

200 

160986 

169971  * 

+ 7.  50 

s s 

200 

167560 

18755!  * 

+ A . 50 

SS 

100 

I 6A339 

16A325  * 

+ I A. 00 

s s 

200 

1 ASS  1 3 

1A8805  * 

+ A . 0 0 

s s 

200 

1 8 7 A 50 

187AA5  * 

+ 2 • 50 

SS 

200 

18A990 

18A976  * 

+ 7.00 

SS 

200 

189737 

1 89  72 A * 

+ 6.  50 

s s 

250 

187251 

187230  * 

+ 8.  A0 

s s 

A00 

1 7AA78 

1 7 A A 7 1 + 

+ 1.75 

s s 

200 

1 575C5 

1 5 7 A 8 2 * 

+ 1 1 . 50 

s s 

1 00 

1 8888  A 

188871  * 

+13.00 

c c 

1 00 

23A882 

23A881  * 

+ 1.00 

s s 

1 50 

23739  3 

237388  * 

+ 3.  33 

SS 

100 

227523 

227510  * 

+13.00 

SS 

75 

2376 A0 

2 37  59  7 * 

+57. 33 

SS 

200 

2279  52 

227950  * 

+ 1.00 

SS 

1 00 

2A1 239 

2 A 1 2 30  * 

+ 9.0P 

SS 

A00 

238269 

238263  * 

+ 1 . 50 

SS 

1 00 

238 1 99 

238160  * 

+39.00 

LBUF 


4 

S4  1 55 

+ 1 004. 50 

4 

111  2 55 

+ 7.  50 

4 

S4  2 55 

+ 4 . 50 

4 

111  1 55 

+14.P0 

4 

18  2 S5 

+ 4.00 

4 

I 7 2 55 

+ 2.  50 

4 

16  2 S 5 

+ 7.00 

4 

51  2 55 

+ 6.  50 

4 

1 6 1 SS 

+ 8.40 

4 

52  1 55 

+ 1.75 

4 

18  1 SS 

+11.50 

4 

110  2 55 

+13.00 

4 

110  1 55 

+ 1.00 

4 

17  1 55 

+ 3.  33 

4 

113  1 55 

+13.00 

4 

112  1 55 

+57. 33 

4 

51  1 55 

+ 1.00 

4 

110  2 55 

+ 9.00 

4 

52  2 r 5 

+ 1.5P 

eme 

Figure  4 Sample  Input  and  Computation  for  Suspended  Solids 


FN  AX  NO  “N 

CM  I NO-M 

CA  0 

DA  1 

ETA 

MACH  EH 
PFCHEM 

L5FJC  NO-M 

+ 2.00 
+ p.  00 
+ 1.00 


0 1 0 1 

-.0  20 
. CC  1 /-763 

• I DF i Cl 
DFAKF 


— 0 * 17  2 
+ 0.00 


ON 

CON  PAT 

8 13  1 NO-M  24  5 * +2. A3 

8 18  2 NO-M  28*2  25  * +14.69 


ENT 


Figure  5 Sample  Input  and  Computation  for  Nitrite-Nitrate 


<•2 


1 


FiJAM  PH 

1 0 1 

NACHEM 

02  BROVN 

13  111  2 Pj; 

e.  7 

13  19  2 PH 

7.  1 

13  110  2 PH 

11.2 

\ 

13  18  2 PH 

6.  I 

13  17  2 PH 

7.0 

13  15  2 PH 

7.  7 

13  54  2 PH 

7.  1 

13  S2  2 PH 

7.  2 

1 3 SI  2 PH 

6.9 

13  111  1 PH 

9.0 

13  112  1 PH 

11.9 

13  19  1 PH 

9.0 

13  18  1 PH 

6.9 

13  16  1 PH 

9.4 

13  17  1 PH 

7.  1 

13  15  1 PH 

8.8 

13  54  1 PH 

7.  4 

13  52  1 PH 

9. 4 

13  51  1 PH 

9.  1 

END 

Figure  6 Sample 

Input  and  Computation  for  PH 

FN  AM  50  4 

03  03 

NACHEM 

0 3 HOLLA 

CM  SO  4 

0 

L1FMC  504 

DA  0 - 

• 424465 

DA  1 - 

• 1 4041  1 

EDA 

+ 2.00 

+ 0. 00 

-0.42  ** 

-0.42 

+ 1.00 

-0.14  ** 

- 0 . 14 

ON 

LSFNC  SO  4 

+ 2.  00 

+ 0.00 

-0.  42 

+ 1.00 

-0.14 

PRCHEM 

HOLLA 

* 

12  113  2 504 

50  50  * 

+709. 71 

12  112  2 SO  4 

4 3 2 5 * 

+ 304.9  3 

12  113  1 50  4 

25  100  * 

+ 709.  71 

FND 


Figure  7 Sample  Input,  and  Computation  For  Sulfates 


**3 


fmam 

C2HCL3 

0 1 0 1 

MACH  EM 

0 1 

DRAK  F 

L 1 FN  C 

C2HCL3 

DA 

0 0 

DA 

1 .0475907 

EDA 

+ 2. 

00 

+ C • 

00  +0. 

00  ** 

+ 0.00 

♦ 1 • 

00  + 0 . 

0 5 ** 

+ 0.05 

ON 

MNVAL 

C2HCL3 

.05 

6 15  1 

C2HCL3 

0 ★ < 

+ 0.05 

6 16  1 

C2HCL3 

14.4  * 

+ 0. 69 

6 S4  1 

C2HCL3 

0 *< 

+ 0.05 

6 110  1 

C2HCL3 

0 * < 

+ 0.05 

6 S2  1 

C2HCL3 

0 * < 

+ C.  05 

6 18  1 

C2KCL3 

0 * < 

+ 0.B5 

7 13  1 

C2HCL3 

4.6  * 

+ 0.22 

7 16  1 

C2HCL3 

61  * 

+ 2.90 

7 110  1 

C2HCL3 

0 *< 

+ 0.05 

7 54  1 

C2HCL3 

0 * < 

+ 0.05 

7 S2  1 

C2HCL3 

0 *< 

+ 0.05 

7 I 1 3 1 

C2HCL3 

2 * 

+ 0.10 

7 19  1 

C2HC.L3 

6.  1 * 

♦ 0.20 

END 

Figure  8 Sample  Input  and  Computation  for  C^HCL^ 


1 

FN  AM 

CH  CL  3 

01  0 1 

CM  ] 

CHCL3 

DA 

0 0 

DA 

1 . 

0 380789 

EDA 

ON 

NACHEM 

01  DRAKE 

p P.  CH  EM 

DFAKE 

6 15  1 

CHCL3 

7.8  * 

+ 0 • 30 

6 16  1 

CHCL3 

8.2  * 

+ 0.31 

6 S4  1 

CHCL3 

6.9  * 

+ 0.26 

6 I1C 

1 CHCL3 

5.2  * 

+ 0.20 

6 52  1 

CH  CL  3 

5 * 

+ 0.  19 

6 18  1 

CHCL3 

8.3  * 

+ 0. 32 

7 18  1 

CH  CL  3 

11.3* 

+ 3.43 

7 16  1 

CHCL3 

10.3* 

+ 0.  39 

7 110 

1 CH  CL  3 

11.5  * 

+ P . 4 4 

7 54  1 

CH  CL  3 

11.8  * 

+ 0.45 

7 52  1 

CHCL3 

11.8  * 

+ 0 • 45 

7 113 

1 CH  CL  3 

12.4  * 

+ 0.47 

7 19  1 

CHCL3 

12.7* 

+ 0.48 

F.ND 

Figure 

9 Sample 

Input  and  Computation  for  CHCL^ 



*5 

A 

DM  AM  COND 

NACHEM 

ON 

13  16  2 CON  D 

0 1 0 1 
0 2 EDO  VN 

521  2? 

1 . 

* 

+552. 26 

1 3 

111  2 

COND 

18  1 20 

1 . 

, He 

+ 19°.  1C 

1 3 

19  2 

COND 

134  21 

1 • 

* 

+144.72 

I 3 

110  2 

COND 

184°  22 

1 • * 

+1050.40 

1 3 

18  2 

CON  D 

143  23 

1 . 

* 

+ 1 57. 30 

1 3 

17  2 

CON  D 

2 77  20 

1 . 

* 

+ 334. 70 

1 3 

15  2 

COND 

668  19 

1 • 

He 

+ 764-  19 

1 3 

S4  2 

COM  D 

136  16 

1 . 

He 

+173.54 

1 3 

S2  2 

CON  D 

158  17 

1 . 

He 

+194.66 

l 3 

5 1 2 

COND 

149  16 

1 . 

He 

+1 77.01 

1 3 

111  1 

COND 

1 40  6 

1 . 

He 

+21 5. 60 

i 3 

110  1 

COND 

5330  i 

1 6 

J • * 

• ..1  .27 

1 3 

110  1 

COND 

1S2  18  1 

• He 

+216. 22 

1 3 

19  1 

COND 

128  16 

1 . 

* 

+163*33 

1 3 

18  1 

CON  D 

394  1 5 

1 . 

He 

+520.08 

1 3 

I 6 1 

COND 

211  5 

1 . 

He 

+333. 36 

1 3 

17  1 

CON 

6 17  16 

1 . 

He 

+ 787.  29 

t 3 

I 5 1 

COM  D 

146  18 

1 . 

He 

+ 1 73.  45 

1 3 

S4  1 

CON  D 

144  4 

1 . 

He 

+233. 28 

I 3 

51  l 

COND 

101  3 

1 • 

jfr 

+167.66 

END 

Figure  10  Sample  Input  and  Computation  for  Specific  Conductivity 
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FN  AM 

T S 

3 1 

MACH  EM 

ON 

CN 

4 112 

T C 

2 TS 

3 TOLL A 
1 00 

942455  942160  * 

+295. 00 

4 

52 

2 TS 

P.49  19  1 849084  * 

+ 107.00 

4 

I 1 3 

2 TS 

356571  85521 6 * 

+ 1 355.00 

4 

SI 

1 TS 

869571  869465  * 

+106.00 

4 

I 1 2 

1 TS 

923690  931 557  * 

- 7867.00 

4 

I 1 3 

1 TS 

974954  973508  * 

+ 1 446. 00 

4 

I 7 

1 TS 

935940  935767  * 

+ 1 73. 00 

4 

I 10 

1 TS 

879857  877791  * 

+2G66.00 

4 

I 10 

1 TS 

946870  946808  * 

+62.00 

4 

13 

n ~ c 

«—  • — - 

1 3861 7 1 1 386046  * 

+ 135.00 

4 

52 

1 TS 

899233  899124  * 

+ 1 09.00 

4 

I 6 

1 '.TS 

979061  978969  * 

+92.00 

4 

51 

2 TS 

709432  709340  * 

+92.00 

4 

16 

2 T S 

722398  722276  * 

+ 1 22.00 

4 

I 7 

2 TS 

7C5900  705766  * 

+ 1 34.00 

4 

18 

2 TS 

71  5717  715581  * 

+1 36.00 

4 

I 1 1 

1 TS 

716358  716150  * 

+208.00 

4 

54 

2 TS 

878040  877031  * 

+109.00 

4 

I 1 1 

2 TS 

1298719  1298405 

* +314.00 

4 

54 

1 TS 

90 6 1 C 6 9G5947  * 

+159.00 

END 

Figure  II  Sample  In,  l and  Computat ion  for  Total  Solids 
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FNAM 

G<SO 

01  01 

M A CHE  5 
ON 

0 ! DRAK E 

S 51  1 

GAO 

900  809373 

809391  * 

+31-89 

8 S2  1 

G&O 

923  563842 

563724  * 

+12.83 

3 54  1 

Co.0 

880  8271 1 A 

S270G8  * 

+12.35 

8 18  1 

G£Q 

940  831119 

8 31006  * 

+11.81 

8 10  l 

C£0 

3 30  738  6(7 

738463  * 

+24. 58 

3 16  1 

0(0 

955  562866 

561850  * 

+106. 39 

8 17  1 

GZO 

920  57324C 

572965  * 

+29.89 

8 15  1 

C£0 

940  564310 

563339  * 

+ 103. 30 

8 110  1 

GAO 

945  590 1 PP 

588039  * 

+215.10 

8 113  1 

C-AO 

935  563303 

' 562814  * 

+52. 30 

9 18  1 

GAO 

940  562316 

562061  * 

+ 27.  1 3 

9 52  1 

GAO 

900  588550 

588310  * 

+26.67 

9 19  1 

CAO 

900  809357 

809087  * 

+30.00 

9 S4  1 

CiO 

900  569090 

568823  * 

+29. 1 1 

9 113  1 

GdO 

930  532547 

532158  * 

+ 43.  22 

9 17  1 

cao 

920  578150 

577703  * 

+48. 59 

9 15  1 

C£0 

915  82G150 

319062  * 

+ 1 18.91 

9 I IP  1 

cao 

° 1 5 836401 

826763  * 

+834. 75 

9 16  l 

G&O 

945  793018 

791995  * 

+108.25 

END 

Figure  12  Sanple 

Input  and  Cnmputat ion  for 

Greases  and  Oils 
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FNAM 

CM1 

DA 

CA 

EDA 

MACH  EM 
ON 

mmval 

MX  UAL 
COM  DAT 
CHCAL 

LSFNC 

+ 2 
+ 0 
+ 1 

PRCHEM 

LSFNC 

+ 6 
+ 5 
+ 10 
+ 1 5 

+ 20 
+ 25 
+ 30 

3 15  1 

8 15  2 

8 16  1 

8 16  2 

8 17  1 

8 17  2 

8 18  1 

8 18  1 

8 19  2 


MBAS 

2 01 

MBAS 

0 

1 • 08536 

1 

196.251 
0 2 BROWN 

MBAS 

1 . 

MBAS 

40 

MBAS 

.4128  2 *> 

+ 40 . 00 

MBAS 
. 00 

. 00 

+ 1.09 

. 00 

+ 196.25 
BROWN 

COND 

.00 

. 00 

+ 1 . 58 

. 00 

+ 1 . 33 

. 00 

+ 1 . 32 

.00 

+ 1.10 

. 00 

+ 1.00 

. 00 

+ 0.90 

MEAT 

.4123  r *> 

+40.00 

MBAS 

.5475  2 *> 

+40.00 

MEAS 

.5998  5 * 

+23. 63 

MBAS 

.6520  5 * 

+25.67 

MBAS 

1 . 1 380  20  * 

+11.16 

MBAS 

1.2250  20  » 

+12.01 

MBAS 

.0578  100  *< 

+ 1.00 

MBAS 

.0154  50  *< 

+ 1.00 

MBAS 

. 5190  20  * 

♦5.12 

8 110  1 MBAS 


3355  20  * 


+ 3.  33 


MORT- 


8 

110  2 MBAS 

. 1 4 68 

30 

*< 

+ 1.00 

8 

111  1 MBAS 

.038  1 

30 

* < 

+ 1 . 00 

8 

111  1 MBAS 

.0557 

30 

♦ < 

+ 1 • 00 

8 

1122  MBAS 

.9693 

20 

* 

+ 9. 52 

8 

113  1 MBAS 

. 5330 

20 

* 

+ 5.26 

8 

1132  MBAS 

.3611 

20 

* 

+ 3.  58 

8 

SI  1 MBAS 

.0252 

100 

*< 

+ 1 . 00 

8 

SI  2 MBAS 

. 0089 

1 00 

*< 

+ 1 . 00 

8 

S2  1 MBAS 

.0109 

100 

* < 

+ 1.00 

8 

S2  2 MBAS 

.0216 

I 00 

*< 

+ 1.00 

8 

SA  1 MBAS 

• 0260 

1 00 

*< 

+ 1 • 00 

8 

SA  2 MBAS 

• 0222 

1 00 

♦ < 

+ 1 • 00 

EPFENC 

L 1 FN  C 

MBAS 

DA 

2 A 

DA 

1 2 

DA 

3 6 

DA 

A 8 

DA 

10 

EDA 

+ 5.  00 

+ 2.00 

+ A . 00 

* * 

+ A.  00 

+ 1.00 

+ 2.00 

** 

+ 2.00 

+ 3. 00 

+ 6.00 

** 

+ 6.  00 

+ A.  00 

+ 8.00 

* * 

+ 8.00 

♦10.00 

+20.00 

* Jit 

+20.00 

L SEN C MBAS 

+ 2.00 

+ 0.00 

+ 0 . 00 

+ 1.00 

+ 2.00 

END 

Fiqurr  13  Sample  Input  and  Computation  for  MBAS 
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CN  NH3-M  3.45293 
ON 


O40898 5 


8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 

8 


SI 

1 PJH3-N 

165.7  1 

' * * 

+ 0.00 

S2 

1 NH3-N 

150.2  1 

* * 

+ 0.01 

S4 

1 NH3-N 

146.3  1 

* * 

+ 0.01 

I 5 

1 NH3-N 

57.4  1 

** 

+ 0.3  3 

I 6 

1 NH3-N 

119.0  1 

* * 

+ 0.03 

I 7 

1 MH3-N 

111.5  1 

** 

+ 0.04 

18 

1 NH3-N 

45.  7 1 

+ 0.  53 

19 

1 NH3-M 

59. 4 1 

3*:  ♦ 

+ 0.  30 

I 10 

1 NH3-M 

61.9  1 

** 

+ 0.27 

I 1 1 

1 NH3-N 

68.  7 1 

** 

+ 0. 21 

I 1 2 

1 NH3-N 

62.  6 1 

♦ * 

+ 0.27 

I 1 3 

1 NK3-N 

106.  3 

1 ** 

+ 0.04 

SI 

2 NH3-N 

88.8  1 

* * 

+ 0.09 

S2 

2 MH3-M 

106.5  1 

♦ 4c 

+ 0.04 

S4 

2 NH3-N 

116.9  1 

♦ * 

+ 0.03 

I 5 

2 NH3-M 

47.2  1 

** 

+ 0 . 50 

I 6 

2 NH3-U 

93.6  1 

+ * 

+ 0.08 

17 

2 NH3-N 

106.7  1 

** 

+ 0 . 04 

I 10 

2 NH3-N 

-2.4  I 

** 

+ 3.81 

1 1 1 

2 NH3-N 

57.  9 1 

** 

+ C.  32 

I 1 3 

2 NH3-M 

98.9  1 

♦ * 

+ 0.06 

Figure  1 Sample  Input  and  Computation  for  Ammonia 


LIST 


The  Data  Handling  System  provides  the  capability  of  listing  data 
files,  information  files,  and  the  ID  tags  on  the  Teletype.  This  listir. 
software  is  loaded  by  the  commands: 

. R DAHDLR 

When  loaded,  the  system  will  respond  with 

DATA  HANDLER 
FUNCTION? 

where  the  operator  must  enter  the  appropriate  listing  command.  Any  u-.er 
device  name  such  as  device  DATA  and  device  INFO  must  have  been  define  • ' 
the  OS/8  monitor  with  the  ASSIGN  command  prior  to  calling  this  proora  . 
Any  attempt  to  list  a nonexistent  rile.  or  a file  in  the  wrong  format  : H 
result  in  an  error  with  the  system  returning  to  the  Key  Board  Monitor. 

Data  Files: 

Data  files  can  be  listed  on  the  Teletype  with  either  the  command  LI 
or  the  command  LISTPRI.  The  command  LISTPRI  ignores  the  secondary  ID  : 
Two  examples  are  shown  to  illustrate  this  data  file  listing  concept.  TPe 
user  of  the  system  must  supply  the  file  name  to  the  system. 

Informat  ion  Fi les: 

Information  files  can  be  listed  on  the  Teletype  with  either  th< 
command  LINFO  or  LISTINF.  The  command  LINFO  lists  the  temporary  inforra- 
tion  file  I NFO : INFO. IN  which  is  created  during  report  and  print-plot 
generation.  The  command  LISTINF  permits  the  operator  to  list  an  infor-.t- 
tion  file  with  an  arbitrary  name. 
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The  example  shown  lists  the  file  INFO: IN FO  IN  which  contains  2 records. 


Short  ID  Tags: 

The  short  ID  tags  belonging  to  any  ID  class  may  be  listed  on  the 
Teletype  by  entering  the  command  LISTSD.  This  listing  shows  both  the 
internal  ID  tag  and  the  short  external  ID  tag.  The  ID  tags  are  handled 
internally  by  the  Data  Handling  System  as  positive  integers  between  I and 
63  where  the  external  representation  is  a character  string.  The  listing 
of  the  Chemist  ID  class  provides  a correspondence  between  external  and 
internal  ID  tags  required  by  the  file  naming  command  step  during  data 
entry.  Examples  are  shown  to  illustrate  the  listing  of  each  ID  class. 
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FUNCTION? LI  ST 


INPUT  F 1LE?  D1  SM05.02 


1 3 

S2 

1 

TALK 

69.0749 

T j SMITH  AP 

1 3 

S4 

1 

talk 

70. 6099 

CLj Cj  SMITH  AP 

1 3 

IS 

1 

talk 

313.  14  LC.  C.  SMITH  AP 

1 3 

S 2 

1 

talk 

64.4699 

IC. C.  SMITH  10 

1 3 

16 

2 

talk 

322.  35  LC.  C.  NH.  SMITH  10 

1 3 

19 

o 

talk 

46.05  CL 

. C.  SMITH  AF 

1 3 

I 7 

r\ 

talk 

76. 7499 

CL.  C.  SMITH 

1 3 

I 5 

r*> 

cl 

TALK 

194.945 

CL. C.  SMITH  AP 

I 3 

S4 

O 

d 

TALK 

55.26  CL 

. C.  SMITH  AP 

1 3 

S2 

2 

TALK 

61.4  CL. 

C.  SMITH  AP 

1 3 

SI 

2 

TALK 

56.  795  L C.  C.  SMITH  AP 

1 3 

I 1 1 

2 TALK 

82.8899 

CL.  C.  SMITH  AP. 

1 3 

I 1 0 

2 TALK 

1105.2 

CL. C.  SMITH  AF 

1 3 

18 

2 

TALK 

30. 7 LC. 

H.  SMITH 

INPUT  FILE  D1SM05.02  HAS  1 4 POINTS 
Figure  15  Sample  Listing  of  Data  File 

FUNCTION7LI STPRI 
INPUT  FILE7D1BR27.01 


8 

15  1 MBAS 

> 40 

8 

15  2 MBAS 

> 40 

8 

16  1 MBAS 

23.6291 

8 

16  2 MBAS 

25. 6667 

8 

17  1 MBAS 

11.1  592 

8 

17  2 MBAS 

12.0082 

8 

18  1 MBAS 

< 1 

8 

18  1 MBAS 

< 1 

8 

19  2 MBAS 

5.11881 

8 

110  1 MBAS 

3.  3281  7 

8 

110  2 MBAS 

< 1 

8 

111  1 MBAS 

< 1 

8 

111  1 MBAS 

< 1 

8 

112  2 MBAS 

9.51  784 

8 

113  1 MBAS 

5.  25543 

8 

1132  MBAS 

3. 57798 

8 

SI  1 MBAS 

< J 

8 

SI  2 MBAS 

< l 

8 

S2  1 MBAS 

< J 

8 

S2  2 MBAS 

< 1 

8 

S4  1 MBAS 

< J 

8 

$4  2 MBAS 

< 1 

INPUT  FILE  D1BP.27.01  HAS  22  POINTS 

Figure  16  Sample  Listing  of  Data  File  with  Primary  ID  Tags 
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FUNCTI0N7LINF0 


INFO  RECORD  = 1 

1 3 2 4 0 0 

DAY 
1 1 
PNT 

1 SI 

2 S2 

3 S4 

4 15 

5 16 

6 I 7 

7 18 

8 110 
9 113 

PEP. 

1 2 
PAR 

1 PH 

2 COND 

3 TALK 

4 TURB 

5 TOC 

6 TS 

7 VS 

8 TDS 

9 NH3-N 

10  NO-N 

11  PO  4 

12  SO  4 

1 3 MBAS 
14  PHENOL 
1 5 GAO 
16  BOD 
CIS 

SEGMENT  * 5 

OPTION  * REPORT 
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INFO  RECORD  = 2 

1 3 2 4 0 0 

DAY 
1 2 
PNT 

1 SI 

2 S2 

3 S4 

4 I 5 

5 16 

6 I 7 

7 18 

8 110 
9 113 

PER 
1 1 
2 2 
PAR 

1 PH 

2 CON  D 

3 TALK 

4 TURB 

5 TOC 

6 TS 

7 VS 

8 TDS 

9 NH3-N 

10  NO-N 

11  PO  4 

12  SO  4 

1 3 MBAS 

14  PHENOL 
1 5 G&O 

16  BOD 
DI  S 

S EC-M  EN  T = 5 

OPTION  = REPORT 


Figure  17  Sample  Listing  of  Informat 


1 


ion  File 
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FUNCTI0N7LI STSD 


I T?  DAY 


1 

1 

2 

2 

3 

3 

4 

4 

5 

5 

6 

6 

7 

7 

8 

8 

9 

9 

1 0 

10 

1 1 

1 1 

1 2 

1 2 

1 3 

1 3 

1 4 

1 4 

1 5 

1 5 

1 6 

1 6 

1 7 

1 7 

18 

MAX 

19 

MIN 

20 

AVE 

21 

NPTS 

22 

RANGE 

23 

STD 

Figure  18  Sample  Listing  of  Day  ID 
FUN  CTION?  L I STSD 
I D?  PN  T 

1 SI 

2 S2 

3 S3 

4 S4 

5 I 5 

6 16 

7 17 

8 18 

9 19 

10  110 
11  111 
12  112 

13  113 

14  P51 

Figure  13  Sample  Listing  of  Point  ID 
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FUN  CT ION? LI 5TSD 


i r?  paf. 


1 

TEMP 

2 

PH 

3 

con  r 

A 

ACI  D 

c 

talk 

6 

GfiO 

7 

TURB 

8 

TS 

9 

SS 

10 

DS 

1 1 

VS 

1 2 

TOC 

1 3 

cor. 

1 A 

BOD 

1 5 

tkm 

1 6 

AL 

1 7 

4-i V 

18 

P0  4 

19 

PHENOL 

20 

CP 

21 

PB 

22 

FE 

23 

CL 

24 

SO  A 

25 

FLOV 

26 

HART 

27 

MBA  5 

26 

NH3-N 

29 

NO-N 

30 

N CEL 

31 

CA 

32 

TDS 

33 

VSR 

34 

CCL4 

35 

BENZ 

36 

C2HCL3 

37 

CHCL3 

38 

TC 

39 

TIC 

Figure  20  Sample  Listing  of  Parameter  ID  Tags 
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FUMCTI0N7LI STSD 


I  D?  PER 

1 1 

2  2 

3 3 

4 IA 

5 IB 

6 1 C 

7 2 A 

8 2B 

9 2C 

Figure  21  Sample  Listing  of  Period  ID  Tags 

FUN  CTI ON? L I STSD 
I D?  DI  S 

1 1 


2 

2 

3 

3 

4 

4 

5 

5 

6 

6 

7 

7 

8 

8 

9 

9 

IB 

10 

1 1 

1 1 

1 2 

1 2 

1 3 

1 3 

1 4 

1 4 

1 5 

1 5 

1 6 

1 6 

1 7 

1 7 

18 

18 

19 

19 

20 

20 

21 

21 

22 

22 

23 

23 

24 

24 

25 

25 

2fc 

26 

27 

27 

28 

28 

Figure  22  Sample  Listing  of  Discrete  ID  Tags 
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FUN  CTION?  L I STSD 

I D?  COM 

1 < 

2 > 

3 * 

A 0 

Figure  23  Sample  Listing  of  Comment  ID  Tags 

FUN  CTI ON?  L I STSD 
I D?  CHEM 

1 DRAKE 

2 BROVIN 

3 VOLLA 
A ROZAK 
5 SMITH 

Figure  2k  Samp  1 e Listing  of  Chemist  ID  Tags 

FUN  CT I ON? LI STSD 
I D7  0UAL 

1 T 

2 CL 

3 LC 
A IC 

5 H 

6 C 

7 G 

8 NH 

9 IP 

10  QS 

Figure  25  Sample  Listing  of  Quality  ID  Tags 

FUN  CT I ON?  L I STSD 
I D?  A C C 

1 AR 

2 10 
3 OM 
A IR 

Figure  26  Sample  Listing  of  Accuracy  ID  Tags 
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MERGE 


Each  of  the  files  created  during  the  data  entry  step  can  be  merged 
into  a master  data  file  using  the  program  MERGE. SV . The  program  MERGE 
lists  the  name  of  each  data  file  which  has  not  yet  been  merged  and  receives 
a response  from  the  supervisor  on  the  particular  action  to  be  taken.  The 
program  MERGE  also  provides  the  capability  to  either  delete  measurements 
or  change  measurements  within  the  master  file. 

The  merge  operation  is  normally  requested  by  the  command 
.SUBMIT  MERGE 

which  submits  the  BATCH  input  file  MERGE. Bl  to  the  OS/8  program  BATCH. 

This  command  has  the  data  handling  system  perform  the  following  steps: 

1.  Create  the  files  SYS : SYSD I R . AR  and  DSK: DSKD I R . AR  with  the 
system  program  DIRECT.  These  files  contain  the  names  of 
all  files  whose  names  begin  with  Dl,  D2,  D3,  and  MASTER. 

2.  Run  the  program  MERGE. SV  to  create  a new  master  data  file 
by  updating  the  current  master  data  file. 

3.  Change  the  first  letter  in  the  name  of  each  file,  used  to 
update  the  master  file,  to  the  letter  A with  the  system 
program  FOTP. 

The  MERGE  program  accepts  as  input  one  master  file  to  be  updated 
and  up  to  25  data  files  which  are  merged  into  a new  master  file  by  this 
program.  In  addition,  one  change  data  file  and  one  deletion  data  file 
may  be  optionally  accepted  as  input.  All  measurements  within  the  data 
deletion  and  data  change  files  are  first  read  into  a data  array.  Each 
measurement  from  the  master  file  is  then  compared  to  the  measurements  in 
this  data  array.  Whenever  the  Day,  Point,  Period,  Parameter,  and  Discrete 
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r 

ID  s imu 1 tane i os  1 y agree,  the  measurement  in  the  master  input  file  is  either 
deleted  or  changed.  The  measurements  within  the  data  addition  files  are 
merged  directly  into  the  new  master  file  and  are  not  compared  to  the 
measurements  in  these  data  arrays  of  change  and  deletion  measurements. 

The  file  DSK: UPDATE . ER  is  created  with  a message  to  the  supervisor 
whenever  a match  from  the  master  input  file  is  not  found  for  all  entries 
in  this  data  array.  This  file  contains  those  measurements  for  which  a 
match  cannot  be  found.  The  file  UPDATE. ER  can  be  listed  with  the  list 
option  found  within  the  program  DAHDLR. 

When  loaded,  the  MERGE  program  provides  a brief  summary  of  the  merge 

commands  which  are  shown  as  follows: 

COMMANDS  ARE  AS  FOLLOWS; 

AD,  ADD  DATA  IN  THIS  FILE  TO  MASTER  FILE 
CH,  CHANGE  DATA  FILE 
DEL,  DELETION  DATA  FILE 
NULL  RESPONSE,  NO  ACTION 

The  program  then  lists  the  names  of  the  files  on  the  device  DSK:,  one 

file  name  at  a time,  for  which  the  supervisor  must  respond  with  either 

a AD,  DEL,  CH,  or  null  ine.  This  procedure  is  then  repeated  for  the  files 

on  the  device  SYS:.  An  example  of  this  print-out  is  as  follows: 

DSK: FILES 

DATE  19-0  CT- 75 

DSK:  D1  VO07.0  1 ? AD 
DSK: D1BR09.027AD 
DSK: D1 DR02. 0 1? AD 
DSK:  D1  BR  1 6. 02?  AD 
DSK: D1 DR06.0 1 ? A D 

SYS:  FILES 
DATE  19-0CT-75 
OTHER  FILES? 

LAST  MASTER  dsK: MASTEP. 0 1 
OUTPUT  FILE?  SYS:MASTEF.  02 
MASTER  INPUT  FI  LE?MA  STEP.  0 I 
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The  program  gives  the  supervisor  the  option  of  specifying  one  or 
more  data  addition  files  whose  names  differ  from  the  file  naming  conven- 
tion. The  message 

OTHER  FILE? 

is  listed  on  the  Teletype.  A null  response  to  this  message  terminates 
this  section  of  the  program.  Otherwise,  this  question  is  repeated  until 
a null  response  is  received. 

The  program  searches  the  files  DSKDIR.AR  and  SYSDIR.AR  for  those 
files  with  a name  of  MASTER.  The  master  file  which  has  the  largest  ex- 
tension is  selected  by  the  porgram  as  the  last  master  file  with  the  mes- 
sage such  as 

LAST  MASTER  DSK : MASTER . 09 

being  printed.  The  program  then  requests  from  the  supervisor  the  name  of 
the  next  master  file  with  the  message 
OUTPUT  FILE? 

It  is  recommended  that  the  supervisor  use  the  name  of  MASTER  with  an  ex- 
tention  derived  by  incrementing  the  extension  on  the  last  master  file. 

The  program  then  requests  from  the  supervisor  the  name  of  the  master 
input  file  with  the  message 

MASTER  INPUT  FILE? 

The  supervisor  would  normally  respond  by  typing  in  the  name  of  the  last 
master  file.  A null  response  to  this  question  is  permitted.  However, 
this  question  is  asked  twoce  whenever  the  first  response  is  null. 

The  program  prints  the  name  of  each  file  when  the  program  is  u^ing 
this  file  to  update  the  master  file.  The  name  of  each  file  used  to  updau 
the  master  file  has  its  name  changed  to  provide  the  data  handling  system 
with  an  accounting  technique. 
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REPORT  GENERATION 


The  Data  Handling  System  is  capable  of  generating  reports  and  print- 
plots  of  selected  data  using  a wide  variety  of  report  and  print-plot 
formats.  The  general  report  formats  are  determined  by  the  sorting  order 
and  are  shown  for  continuous  and  discrete  data  in  the  following  figures. 

Continuous  Data  Report  Format 
Cont i nuous 

First  Order  Second  Order 
Third  Order  Fourth  Order  


Discrete  Data  Report  Format 
First  Order 

Second  Order  Third  Order 

Fourth  Order  Fifth  Order 

. 


Report  generation  is  accomplished  by  the  system  in  four  distinct 
steps  which  are: 


6 it 


].  Master  File  Determination 

2.  INFO: IN FO . I N File  Generation 

3.  SORT 

4.  REPORT 

The  file  INFO. IN  contains  one  record  for  each  report  requested. 

Each  record  contains  information  such  as: 

1.  Order  of  Sort  (Report  Format) 

2.  Options  (Report/Plot) 

3.  Segment  Size  (Number  of  Columns) 

4.  ID  1 ists 

During  the  SORT  step,  the  information  necessary  for  the  report  is 
retrieved  from  a specified  data  file  and  sorted.  A temporary  data  file 
is  created  on  device  data  for  each  record  in  the  INFO. IN  file.  The 
REPORT  step  then  formats  and  prints  the  information  in  each  of  these 
temporary  files.  The  REPORT  places  all  output  in  the  file  OUT  : REPORT . RP . 

By  defining  OUT  with  the  ASSIGN  command  as  TTY,  the  reports  and  print- 
plots  will  be  printed  on  the  teletype. 

The  report  generation  step  is  normally  requested  by  the  command 

.SUBMIT  REPORT 

which  submits  the  BATCH  input  file  REPORT. Bl  to  the  OS/8  program  BATCH. 

The  devices  DATA,  INFO,  and  OUT  must  be  defined  to  OS/8  prior  to  starting 
the  report  generation  step.  This  command  has  the  Data  Handling  Syster- 
perform  the  following  steps: 

1.  Create  the  files  SYS  : SYSD I R . AR  and  DSK : DSKD I R . AR  with  the  systc 
program  DIRECT.  These  files  are  created  to  provide  the  program  DAHDLR 
with  the  names  of  all  files  with  the  name  of  MASTER. 
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2.  Run  the  program  DAHDLR.SV  to  create  the  file  I NFO : INFO. IN. 

3.  Run  the  program  SORT.SV  with  the  master  file  and  information 
files  specified  in  step  2 to  create  the  temporary  data  files  for 
the  REPORT  step. 

A.  Run  the  program  REPORT. SV  to  generate  the  reports  and  print- 
plots  specified  in  the  previous  steps.  The  output  is  placed  in  the 
file  OUT : REPORT. RP. 

The  program  OAHOLR  when  loaded  produces  the  following  messages 

DATA  HANDLER 
FUNCT I 0N7REP0RT 

§ 

for  which  the  operator  must  respond  with  the  command  REPORT  to  specify 
the  report  option.  The  pound  sign  (#)  is  used  to  prompt  the  user  that  a 
report  generation  command  is  expected.  The  file  INFO: INFO. IN  contains 
one  record  for  each  report  or  print-plot  specified. 

Before  the  report  generation  commands  are  discussed,  several  listing 
of  records  from  the  file  INFO: IN  with  the  corresponding  report  or  print- 
plot  are  shown  to  demonstrate  the  result  to  be  achieved  from  these  command1 . 
Please  note  that  each  record  of  the  file  INFO. IN  contains  the  following 
i nformat i on : 

1.  Order  of  Sort  (Report  Format) 

2.  Options  (Report/Plot) 

3.  Segment  Size  (Number  of  Columns  in  Report) 

A.  Primary  ID  Lists  (Comment  ID  not  used) 

The  order  in  which  the  IDs  are  placed  within  the  ID  list  determine  the 
order  the  IDs  will  appear  in  a report. 
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f 1 


A given  ID  tag  should  appear  in  a list  only  once  as  the  SORT  step  will 
only  use  the  first  occurrence  of  the  ID.  The  identification  of  rows  in 
a report  requires  25  columns  while  each  column  of  data  requires  9 columns. 
A Teletype  with  72  print  positions  allows  a maximum  segment  size  of  5- 


INFO  RECORD  = 2 

1 3 2 A 0 0 

DAY 

1  1 

PNT 

1 SI 

2 S2 

3 S3 
A SA 

5 15 

6 Ifc 

7 I 7 

8 18 

9 19 

10  110 
11  111 
12  112 
13  113 

PER 
1 2 
PAP 

1 PH 

2 COND 

3 TALK 
A TURD 

5 TOC 

6 TS 

7 VS 

8 TDS 

9 MH3-N 

10  NO-N 

11  PO  A 

12  SO  A 

1 3 MBAS 
1A  PHENOL 
1 5 G«0 
16  BOD 
D I S 

S EGM  FN  T = 5 

OPTION  = REPORT 

figure  27  Information  file  for  Sample  Report 
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TITLE  OF  REPORT 
THIS  IS  A SAMPLE  HEADER 
CL  EM  SOM  UNIVERSITY,  CLEMSON  SOUTH  CAROLINA 


CONTINUOUS  DATA 


DAY  1 

PERIOD  2 

SAM PL  E 

PO  INT 

PH 

COND. 

T.  ALK 

TURD. 

TOC 

SAMPLE 

POINT 

S-  1 

7.  6 

1 76.0 

1 52 

8 

3 

SAMPLE 

POINT 

S-2 

7.  7 

159.9 

69 

5 

8 

SAMPLE 

PO  INT 

S-4 

7.8 

1 44.  7 

57 

4 

20 

SAMPLE 

POINT 

I - 5 

7.  6 

835.  7 

208 

92 

772 

SAMPLE 

POINT 

1-6 

1 2.  0 

2204.8 

3300 

400 

1416 

SAMPLE 

POINT 

1-7 

9.  1 

209.  3 

79 

32 

25 

SAMPLE 

POINT 

1-8 

7.  1 

106.0 

66 

1 

4 

SAMPLE 

POINT 

1-10 

12.  7 

2860.0 

1 3500 

650 

1835 

SAMPLE 

POINT 

1-13 

8.6 

1 647. 8 

327 

42 

50 

T.  SOL 

VOL.  S 

TDS 

NH3-N 

NO-N 

SAMPLE 

PO  INT 

S-  1 

87 

* * * 34c  * * * 

68 

. I 0 

******* 

SAMPLE 

PO  I N T 

S-2 

82 

******* 

79 

. 1 0 

******* 

SAMPLE 

PO  INT 

S-4 

70 

******* 

69 

.07 

******* 

SAMPLE 

POINT 

1-5 

1 59  7 

******* 

1 532 

.05 

******* 

SAMPLE 

POINT 

1-6 

875 

******* 

500 

. 09 

******* 

SAMPLE 

POINT 

1-7 

1 56 

******* 

1 10 

. 09 

******* 

SAMPLE 

POINT 

1-8 

28 

******* 

25 

. 0 7 

1 .02 

SAMPLE 

POINT 

1-10 

1 1 78  3 

******* 

11517 

. 57 

******* 

SAMPLE 

PO  INT 

1-13 

1 198 

******* 

1 1 75 

. 09 

******* 

T.  PO  4 

SO  4 

MBAS 

PHENOi. 

CIO 

SAMPLE 

PO  INT 

S-  1 

******* 

******* 

0 

******* 

******* 

SAMPLE 

POINT 

S-2 

1.15 

******* 

0 

******* 

7 

SAMPLE 

POINT 

S-4 

.26 

******* 

0 

******* 

6 

SAMPLE 

POINT 

1-5 

14.19 

******* 

121 

******* 

******* 

SAMPLE 

PO  INT 

1-6 

******* 

******* 

54 

I 3.  78 

******* 

SAMPLE 

POINT 

1-7 

1 . 30 

******* 

0 

******* 

******* 

SAMPLE 

POINT 

1-10 

******* 

******* 

3 

******* 

******* 

SAMPLE 

POINT 

1-13 

BOC 

1079.0 

4 

******* 

******* 

c AMPL  E 

PO  INT 

1-13 

1 45 

Figure  28  Sample  Report 
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INFO  RECORD  = 5 

1 3 2 4 0 0 

DAY 
1 1 

2 2 

3 3 

4 4 

5 5 

e 6 

7 7 

8 8 

9 9 

10  10 
11  11 
12  12 

13  13 

14  14 

15  15 
PMT 

1 51 

2 52 

3 S4 

4 I 5 

5 16 
TER 

1  1 
2 2 
PAR 

1 PH 

2 COND 

3 TALK 

4 PH 

5 TALK 
n S 

SEGMENT  = 5 

OPTION  =•  PLOT 

f '(jure  29  Information  File  for  Sample  Plot 
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L 


PLOT  1 : PH  AT  SI 

MAXIM UN  = 9.1 

MINIMUM  = 6.8 

AVERAGE  = 7.60768 

NUMBER  OF  POINTS  = 26 

UPPEP  LIMIT  = 9.1 

LOVER  LIMIT  = 1 


PLOT  2 : COM D AT  S2 
MAXIMUM  = 2 33.28 

.if'!:-1  N - 1 49. 606 

AVERAGE  = 1 79. 78  1 

MUMPER  OF  POINTS  = 27 

UPPER  LIMIT  = 2800 

LOVER  LIMIT  = 100 


PLOT  3 : TALK  AT  54 
MAX  I MIN  = 30  7 

MINIMUM  = 50.655 

VERAGI  - 75.  1 4 7< 

111-1 13 EF  OF  POINTS  = 2 7 

UPPER  LIMIT  = 307 

LOVER  LIMIT  = 0 


PLOT  4 : PH  AT  IS 
MAXIMUM  = 12.1 

MINIMUM  = 7.3 

AVERAGE  - 8.254 54 

NUMBER  OF  POINTS  = 22 

UPPER  LIMIT  = 12.1 

LOVER  LIMIT  = 1 


PLOT  5 : TALK  AT  If 
MAXIMUM  = 3300 

1 • 

AVERAGE  = 586.  5.67 

NUMBER  OF  POINTS  = 24 

UPPER  LIMIT  = 3300 

LOVER  LIMIT  = 0 
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List  Editing  Commands: 


The  Day,  Point,  Period,  Parameter,  and  Discrete  ID  lists  can  be 
created,  modified,  and  listed  with  the  following  list  editing  commands. 

LIST  EDITING  COMMANDS 


Command 
NEW  IDLIST 

A IDLIST  I D 1 ID2  . . . I DN 
A I D I ID2  . . . I DN 

D IDLIST  I D I ID2  . . . I DN 
D ID1  ID2  . . . I DN 

C IDLIST  OLDID  NEW  I D 

C CLP  I D NEW  ID 

I IDLIST  OLDID  ID1  I D2  . . . I DN 

I OLDID  ID1  ID2  . . . I DN 

L IDLIST 
L 

AP  PNT  PAR 

AP  DAY  PNT  PER  PAR 

LP 


Delete  all  ertries  in  IDLIST 

Add  I D I . . . I DN  to  IDLIST 

Add  ID1  . . . I DN  to  previously 

named  IDLIST 

Delete  ID1  . . . I DN  from  IDLIST 

Delete  ID1  . . . I DN  from  previously 

names  IDLIST 

Change  first  occurrence  of  OLDID  to 
NEW  ID  in  IDLIST 

Change  first  occurrence  of  OLDID  to 
NEWID  in  previously  named  IDLIST 

Insert  ID1  . . . I DN  before  OLDID 

in  IDLIST 

Insert  IDI  . . . I DN  before  OLDID 

in  previously  named  IDLIST 

List  entries  in  IDLIST 

List  previously  named  IDLIST 

Add  plot  for  continuous  data 

Add  plot  for  discrete  data 

List  plot  lists 


Two  command  modes  are  provided  for  entering  these  List  Editing 
Commands.  For  the  non-string  input  mode  (NSTR) , each  symbolic  name  in 
the  command  must  be  terminated  by  a carriage  return  (RETURN)  with  a null 
line  delimiting  a command  string. 
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An  example  of  a command  in  the  non-string  input  mode  is 
#?A 

7IDLIST 
? I D 1 
? I D2 
? I D3 

? I DN 
? 

where  the  pound  sign  (,#)  and  question  mark  (?)  are  printed  by  the  Data 
Handling  System  to  prompt  the  operator.  The  non-string  input  mode  is 
recommended  over  the  string  input  mode  because  it  is  significantly  faster 
i n execut  ion  time. 

The  string  input  mode  has  the  system  accept  the  list  editing  command 
as  a single  command  line  which  is  terminated  with  a carriage  return.  A 
single  space  separates  each  symbolic  name  in  the  command.  The  execution 
time  for  this  input  mode  may  be  slow  as  a result  of  overlays. 


73 


Report  Generation  Commands : 

Additional  report  generation  commands  are  shown  in  the  following  tables. 


Command 

DISC 

CONT 

DO 

SEG 

LSEG 

END 

RPT 

PLT 

NIDS 

NSTR 

STR 

ORD 

LORD 

LTAB 

STD 


REPORT  GENERATION  COMMANDS 

Ooerat i on 


Select  discrete  data  option 

Select  continuous  data  option 

Create  one  information  record  by  outputting 
the  current  ID  list,  option,  segment  size, 
and  sort  order. 

Enter  new  segment  size 

List  current  segment  size 

End  of  information  file  generation.  Close 
this  information  file 

Set  option  of  current  record  to  report  cptiir 

Set  option  of  current  record  to  plot  option 

Initialize  all  ID  lists  with  zero  entries 

Disable  string  input  mode 

Enable  string  input  node 

Specify  order  of  sort 

List  current  sorting  order 

List  current  status  of  ID  lists,  sort  order, 
option,  and  segment  size. 

Initialize  current  status  of  ID  list, 
sort  order,  option,  and  segment  size  with 
a record  from  the  file  INPO:STD.IN. 
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Standard  Report : 

The  program  DAHDLR  provides  the  capability  of  generating  the  informa- 
tion file  INFOLSTD.IN  with  several  records.  The  command 

STD 

gives  the  user  the  capability  of  initial izing  the  ID  lists,  sort  order, 
option,  and  segment  size  with  any  record  within  this  file. 

Master  File  Selection: 

The  file  INFO; INFO. IN  has  been  created  with  the  END  command  is  giver. 
The  program  then  prints  the  message 

FUNCTION? 

and  the  command 

DOREPORT 

instructs  the  program  to  search  the  files  DSK: DSKDI R.AR  and  SYS  ; SVSC I R . AR 
for  files  with  the  name  MASTER.  These  names  of  these  files  are  typed  on 
the  Teletype  as  follows: 

DSK:  FILES 

MASTER. 10 
MASTER. 1 1 
SYS.  FILES 

MASTER. 12 

MASTER  FILE  INPUT? 

The  operator  must  supply  the  name  of  the  master  input  file  for  this 
report . 
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Report  Generation  w i th  Parameter  Computations 


Report  generation  has  the  capability  to  pern  it  each  report  to 
include  parameters  such  as  range,  maximum,  minimum,  average,  number 
of  points,  and  standard  deviation  for  selected  measurements.  When 
a report  includes  these  parameters,  report  generation  is  accomplished 
by  the  system  in  / steps  instead  of  A steps  which  are  as  follows: 

1.  Master  File  Determination 

2.  INFO: INFO. IN  File  Generation 

3.  IIJFO:  MX  INFO.  IN  File  Generation 
k.  SORT 

5.  MAXMIN  Computations 

6.  SORT 

7.  REPORT 

Steps  3,  A,  and  5 are  entered  only  when  these  parameters  are  computed. 
Steps  3 and  A create  the  sorted  data  files  DATA : DATA. AA , DATA : DATA . AB , 
...,  etc.  which  are  processed  by  step  5 to  yield  the  file  DATA : MAXM I N. 01 
containing  these  parameters. 

The  user  should  read  the  MAXMIN  chapter  before  attempting  to  use 
these  parameters.  The  program  MAXMIN. DA  places  reguirements  on  the 
System  Definition  File  SVSDEF.AR  and  the  input  data  files  to  arrive 
at  meaningful  parameter  computations. 

Examp  I es : 

Some  examples  are  shown  which  illustrate  these  report  generation 
commands. 
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data  handler 


FUNCTION?  PLO~ 

C0NT* r : 

#?  A 
? day 
? 1 
? 2 
? 3 
? A 
? 5 
? 6 
? 7 
? & 

? Q 
? I 0 
? I 1 
? 1 2 
? 1 3 
? I A 
? 1 5 
? 

/•?  A 

? r £r 

? l 

9 O 

• c 

9 

A?  pp 
? c 1 
? PH 

7 

#?  DO 

#?  A P 
? S2 
? COND 

7 

#?  DO 
#?  AP 
? S4 

? talk 

7 

m io 

if?  AP 
? I 5 

? ppj 


#?  DO 


INFO  RECORD  = 6 

1 3 2 4 0 0 

DAY 

1 1 

2 2 
3 3 
A A 
5 5 

« 6 6 


■MGtt  ■ 


data  handler 


FUNCTION?  REPORT 


RPT i PLT? DPT 
CON  T > D I SC?  CO  NT 
#?  LSEC- 

SEG  SIZE  = 5 

<*?  LO  RE 

e 0 3 0 0 0 

#?OFE 
DAY?  1 
PNT?  3 

p rp?  g 

PAD?  A 
#?  A 
? DAY 
? J 


i*?  A 
? PNT 
? SI 
? SO 
? S3 
? S A 
? I 5 
? 16 
? I 7 
? 18 
? 19 
? I I {? 
? I 1 1 
? I 1 2 
? I 1 3 


#?A 
? PEP 
? 

*?  A 
? PAP 
? TH 
? CON  C 

? talk 
? Tunr 
? TOC 


30 


#?  A 
? TS 

? vs 

? td 

7 

ILL  PAR  TD 
(*?  A 
? TS 

? vs 

? TDS 
7NK3-N 
? MO-W 

#?  L 


1 

2 

3 

A 

5 

6 

7 

8 
9 


PH 

CON  C 

talk 

TURB 
TOC 
TS 

y c 
TD? 
NH3-N 
10  NO  “N 
(•?  A 
? PO  A 
? SO  A 
? MBA  S 
? PHENOL 
? GSO 
? 

if?  A 
? BOD 
7 


1 


*?  LTAB 

INFO  RECOFD  = 1 

i  3 2 A Pi  0 


52 

53 

54 

I 5 

i e 

1 7 
18 
IF 

' 110 
I 1 1 
> 112 
! I 1 3 


1 PH 

2 COND 

3 talk 
A TV  RE 

5 TOC 

6 TS 

7 VS 

8 TCS 

9*  NH3-N 

10  NO-N 

11  PO  A 

12  SO  A 

13  NBAS 

14  PHENOL 
1 5 060 

16  BOD 
DI  S 

SEGMENT  = S 
OPTION  = REPOT.T 
#?  L 
? P EP. 


#?A 
? PER 
? 2 
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#?  DO 
#?  C 
? DAY 
? 1 
? 2 
•> 

ttl  LTAB 

INFO  "ECOFD  = 2 

1 3 2 4 0 0 

DAY 

1 2 
PNT 

1 £1 

2 £2 

3 £3 

4 S4 

5 I 5 

6 16 

7 I 7 

8 IS 
Q 19 
10  110 
M 111 
12  112 
13  113 

PER 
1 2 
PAP 

1 PH 

2 COM  D 

3 TALK 

4 TURB 

5 TOC 

6 T £ 

7 VS 

8 TDS 

9 NH3-N 

10  WO -N 

11  PO  4 
1 2 SO  4 

1 3 MBA £ 

14  PH  EM  0 L 
1 5 C<50 

16  BOD 
DI  £ 

5EGMFNT  = 5 

OPTION  = PFPOPT 
£ EG 
? 4 

SEC  SIZE  = 4 

#7  DO 

Fiijurr  33  f'-imple'  of  Information  File  Generation 
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DAHDLR 


The  program  DAHDLR  performs  several  functions  which  include  the  listing 
of  files  in  a variety  of  formats  and  information  file  generation.  The 
program  DAHDLR  is  loaded  by 

.R  DAHDLR 

and  responds  with  the  messages 

DATA  HANDLER 
FUNCTION? 


The  operator  of  r k ■ system  must  respond  by  typing  one  of  the  following  co'-mv- r • 


Command 
REPORT 
PLOT 
PRESTD 
PRE INF 

LlNFC 
LI STINF 

LISTSD 

LIST 

LISTPRI 

STR 

NSTR 

DOREPORT 


DAHDLR  COMMANDS 

Funct i on 

Generate  the  information  file  INFC:INFO.IN 

Generate  the  information  file  INFO:  INFO. IN 

Generate  the  information  file  INFO:STD.IN 

Generate  an  information  file  with  an 
ooerator  specified  file  name 

List  the  information  file  INFO:  INFO. IN 

List  the  information  file  with  an  operah  r 
Spec i f i ed  file  name 

List  the  entries  in  a selected  ID  class 

List  a specified  data  file 

List  a specified  data  file  but  ignore  the 
secondary  ID  tags 

Use  string  input  mode 

Do  not  use  string  input  mode 

Generate  a report  specified  by  I NFO : I NFC . I N 
with  an  operator  specifid  nacttr  file 


mu 


i 

MAXMIN  Generate  the  information 

file  I NFO: MX  I UFO . IN  and 
enable  report  generation 
to  compute  and  use  these 
parameters 

MXMIJ  Generate  the  information 

file  INFO: MX  INFO.  IN 
from  INFO:  INFO.  IN  and 
enable  report  generation 
to  compute  and  use  these 
parameters 

| 

The  operation  of  each  option  specified  by  these  commands  arr 
specified  in  other  chapters  of  this  manual.  The  devices  DATA, 
INFO,  and  OUT  should  be  assigned  prior  to  running  DAHDLR. 
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SORT 


The  program  SORT  retrieves  selected  data  from  a specif  id  data  file, 
sorts  this  data  and  then  places  the  sorted  data  in  an  output  file.  Instruc- 
tions for  this  sorting  operation  are  received  from  an  information  file. 

Each  record  of  this  information  file  contains: 

1 . Sort i ng  order 

2.  10  1 ists 

3.  Segment  size 

A.  Sorting  options 

Each  record  of  the  information  file  defines  a new  sorting  function  which 
results  in  a new  output  file. 

The  SORT  program  may  be  loaded  by 

.R  SORT 

'••(Output  File)  < (Info  File),  (Data  File  I),  (Data  File  2' 

When  loadeu,  the  operator  must  supplv  to  the  Command  Interpreter 

1.  Initial  Output  file  name 

2.  Information  file  name 

3 . First  data  file  name 

A.  Second  data  file  name  (optional) 

The  extension  of  the  initial  output  file  is  incremented  to  determine  the 
name  of  successive  output  files.  The  last  two  characters  of  the  output 
file  name  should  not  be  "D"  as  the  system  uses  this  to  denote  a duplicate 
data  file.  Usually,  the  SORT  option  is  one  step  in  a BATCH  comrand  :rput 

file. 
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An  END  message  will  be  printed  at  the  completion  of  each  sorting  irt-r 
When  all  the  records  of  the  information  file  are  processed,  control  i re- 
turned to  the  OS/8  Monitor. 

Normally,  the  software  names  the  information  file  INFO: INFO. IN  while 
the  output  files  are  named  DATA : DATA . AA , DATA:DATA.AB , etc.  The  extens 
of  the  first  output  file  is  .AA  but  is  incremented  with  each  add  i t n 

output  file. 

The  SORT  program  checks  to  see  if  there  is  2 or  more  points  with 
identical  Day,  Point,  Period,  Parameter,  and  Discrete  IDs  present  in  the 
data  file.  The  first  measurement  encountered  with  this  ID  will  be  used 
the  sorting  operation.  All  remaining  measurements  with  this  ID  are  placer 
in  a duplicate  data  file  with  a DUP.DATA  message  generated  ir  place  cf  fc 
END  message.  If  duplicate  data  were  encountered  while  generating  DAT'"-: 
duplicate  data  would  be  placed  within  the  file  DATA: DATADD.AF. 

When  the  report  sorting  option  is  selected,  the  Day,  Point,  Peri,  i, 
Parameter,  and  Discrete  (Discrete  data  only)  IDs  of  this  measurement  be 
present  in  the  ID  lists  provided  by  the  information  file  U be  selects-  1 
this  sorting  step.  The  plot  sorting  option  additionally  requires  th,  t 
either  the  Point  and  Parameter  ID  for  continuous  data  of  the  Day,  - 
Period,  and  Parameter  ID  for  discrete  data  be  found  in  th«  same  r< 
location  within  the  respective  lists. 
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-- Y S T t f ‘ TABLES 


Several  system  tables  are  used  by  the  system  software  to  define  a 
particular  data  handling  :pplication  to  the  system.  The  system  definition 
file  (SYSDEF.AR)  provides  information  which  includes  lists  of  valid  ID 
tags,  upper  and  lower  limits  for  measurement  values,  data  formats,  and 
various  heading  and  column  infot  at  ion  used  during  report  generation. 

The  translation  table  file  (T  N .AR)  contains  the  translation  tables 
for  the  mark  sense  cards.  The  metnod  file  (METHOD. AR)  specifies  for  each 
parameter  the  particular  data  conversion  algoritL  within  the  function 
file  (FNCTN.AR)  to  use  on  input. 


System  Definition  File  Format: 

The  system  definition  file,  DS K : SYSDE F. AR , is  required  to  define  the 
application  to  the  data  handling  system.  This  file  is  an  OS/8  ASCII  file 
containing  several  character  strings.  A Null  character  string  segments 
this  file  into  several  lists.  These  lists,  in  the  order  of  appearance,  are 
Day  ID  Lists 
Point  ID  Lists 
Period  ID  Lists 
Parameter  ID  Lists 
Discrete  ID  Lists 
Comment  ID  Lists 
Header 

Chemists  ID  Lists 
Qua  1 i ty  ID  Lists 
Accuracy  ID  Lists 
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The  T.. 


'or  ID  list  o ■ i ■■  s C l!ui  .itter  s t r i 


while  the  reclining  primary  ID  lists,  contain  3 character  rtr  igs  ^er 

list  entry.  The  first  3 character  strings  per  primary  ID  list  entry 
provide  alternate  ways  of  externally  representing  this  ID  tag.  The 
name,  length,  and  usage  of  each  ot  these  representations  are  showr  as 
f o 1 1 ows : 


Order 

Name 

Usage 

Fi  rst 

Short  ID 

1-6  char. 

Norma  1 1 y used 

Second 

Long  ID 

-2A  char. 

Header  of  Reports 

Th  i rd 

Column  ID 

1-6  ch'ar. 

Column  header  in  Reports 

The  1st  three  character  stt  ngs  for  each  list  entry  in  the  Parameter 
ID  list  defines  a minimum,  maximum,  and  format  for  each  parameter.  The 
format  is  an  integer  and  specifies  the  number  of  places  to  the  right  of 
the  decimal  point  to  be  used  during  report  generation.  The  minimum  and 
maximum  defines  the  lower  and  upper  limits  during  a print-plot. 

The  header  must  be  3 lines  in  length  ^ven  though  one  or  more  of 
these  lines  are  null.  Each  line  must  contain  less  than  72  characters. 

This  header  labels  each  page  of  the  report  and  print-plot  during  report 
generat i on. 

The  Accuracy  and  Quality  ID  lists  contain  2 character  strings  per 
list  entry.  The  first  string  is  a I to  6 characters  in  length  and  is 
normally  used.  The  second  string  is  i to  2A  characters  in  length  and  pro- 
vides an  alternate  way  of  representing  the  same  ID  information. 

The  Chemist  ID  list  identifies  the  name  of  the  chemist  and  contains 
2 character  strings  per  list  entry.  The  first  string  is  1 to  6 characters 
in  iength  and  provides  an  abbreviated  name.  T^-e  second  string  permits  the 
chemist  to  be  identified  with  a name  which  is  1 to  2^  characters  in  length. 


SYSTEM  DEFINITION  | lE  EDITOR 


The  System  Definition  File  (DSK : SYSDEF. AR)  provides  the  data  handling 
system  with  information  such  as  lists  of  valid  ID  tags,  upper  and  lower 
limits  for  measurement  values,  data  formats,  and  various  heading  and 
column  information  used  during  report  generation.  This  file  is  required 
to  define  the  application  to  the  data  handling  system  and  is  an  OS/8 
ASCII  file  containing  several  character  Strings.  This  file  c ;n  be  < lit 
either  with  the  OS/8  EDIT  program  or  the  BASIC  program  EDITS. BA. 

The  BASIC  program  EDITS. BA  is  an  editor  written  especially  to  list, 
modify,  or  create  the  System  Definition  File  DSKtSYSDEF.AR.  When  loaded, 
the  program  responds  with  the  message 
DEFAULT  FILES? 

A tesponse  of  YES  to  this  quest  on  will  cause  the  program  to  select  the 
default  input/output,  files  of 
DSK : SYSDEF . AR 

For  an  answer  of  110,  the  system  will  explicitly  ask  the  user  for  the 
names  of  the  input  and  the  output  files. 

The  program  now  requests  the  fol lowing  information 
ID  TO  BE  EDITED? 

The  user  must  respond  with  one  cf  the  following  responses: 


DAY  Day  ID  List 

PUT  Point  ID  List 


A0-A036  529 


UNCLASSIFIED 

2 of  2 I 

ADA03B529 


CLEMSON  UN IV  S C COLL  OF  ENGINEERING  F/G  13/2 

A SYSTEMS  ANALYSIS  OF  WATER  QUALITY  SURVEY  DESIGN.  APPENDIX  VII— ETC(U) 
AUG  75  T L DRAKE  DADA17-72-C-2152 


DATE 

FILMED 

3-77 


I 

L 


MICROCOPY  Rl  SOI  01  ION  If  Si  (MAR! 


VV  MA| 


m 


COM 

Comment  ID  List 

HDR 

Report  Header 

QLT 

Qual i ty  ID  List 

ACC 

Accuracy  ID  List 

NAM 

Chemist  ID  List 

END 

End  Edit  Operations 

it  is  reconmended  that  the  user  edit  the  ID  lists  in  the  order  shown  as 
this  minimizes  the  number  of  file  transfers. 

The  program  now  provides  the  message 
CREATE  OR  EDIT? 

for  which  the  user  must  respond  with  the  following  commands: 

CREATE  Create  a New  ID  List 

EDIT  Edit  Existing  ID  List 

Null  Response  Finished,  get  next  ID 

The  CREATE  option  allows  the  user  to  create  a new  ID  list.  The 
user  is  prompted  with  one  or  more  of  the  following  messages: 

SHORT? 

LONG? 

COLUMNS? 

FORMAT? 

MAX  I MUM? 

MINIMUM? 

The  selection  of  the  EDIT  option  will  cause  the  program  to  respond 
wi th  the  message 

ADD,  CHANGE,  OR  LIST? 

for  which  the  valid  responses  by  the  operator  are  as  follows: 

ADD  Append  a New  ID  to  the  List 

CHANGE  Change  an  ID  in  the  List 


01 


LIST 


List  Selected  Entries 


Null  Response  Return  to  Edit  or  Create  Step 

The  ADO  option  wi 1 1 append  a new  ID  list  entry  to  the  end  of  the 
selected  ID  list.  The  CHANGE  option  permits  a current  ID  list  entry 
to  be  modified.  Both  the  ADD  and  CHANGE  operation  will  prompt  the  user 
with  the  same  questions  as  were  used  with  the  CREATE  option. 

The  LIST  and  CHANGE  commands  prompt  the  user  with  the  following 
message 

SHORT  ID? 

The  user  enters  the  particular  ID  in  the  selected  list  to  be  changed  or 
listed.  However,  a response  of  ALL  for  the  LIST  command  causes  the  entire 
list  to  be  listed.  Otherwise,  the  urogram  for  the  LIST  command  will 
request  the  number  of  lines  to  be  printed  starting  at  the  named  short  ID. 

The  program  checks  the  syntax  of  each  input  received.  The  appropriate 
error  message  is  printed  in  response  to  an  incorrect  input. 

The  program  EDITS. BA  has  one  file  open  for  input  and  another  file 
open  for  output.  The  output  file  contains  the  edited  results.  Whenever 
the  ID  lists  are  not  edited  in  the  same  order  as  they  appear  within  the 
System  Definition  File,  then  the  program  may  be  required  to  close  both 
files  and  then  make  the  output  file  the  input  file.  When  this  happens,  i 
new  output  file  is  opened  with  the  same  name  as  the  original  input  file 
and  the  original  input  file  is  usually  lost.  When  this  happens,  the 
program  asks  the  user  whether  to  alter  the  input  file  or  not.  The  user 
must  respond  with  either  a YES  or  ?'I0  answer. 

When  the  default  file  names  are  used,  both  the  input  and  the  output 
files  have  the  same  names.  Whenever  the  output  file  is  closed,  the  input 
file  is  list. 
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PROGRAM  INPUT  GENERATION 


The  program  INPUT  contains  several  tables  which  are  highly  dependent 


on  the  contents  of  the  files  SYSDEF.AR,  METHOD. AR,  TRNTBL.AR,  and  FNCTN.AR. 
Therefore,  this  program  must  be  generated  whenever  any  of  these  files  is 
altered.  The  Batch  file  GENCRH.BI  contains  a list  of  commands  which 
automate  this  procedure.  This  Batch  file  GENCRH.BI,  however,  assumes 
that  the  following  files  are  present  on  DSK:  and  SYS: 

DSK:  Files 


SYSDEF.AR 


System  Definition  File 


METHOD. AR 


Methods  Fi )e 


TRNTBL.AR 


Translation  Tables 


FNCTN.AR 


Funct i ons 


GETPUT.PA 


Source  of  Get-Put  Subroutines 


CRH. PA 


Source  of  INPUT 


IDGEN.BA 


Creates  Temporary  Files 


SYS:  Files 


PAL8.SV 


Assembler 


ABSLDR.SV 


Absolute  Loader 


BCOMP.SV 


BAS  I C Compi ler 


BRTS.SV 


BASIC  Run  Time  System 


BLOAD.SV 


BASIC  Loader 


BASIC.UF 


BASIC  User  Functions 


BASIC.SF 


BASIC  String  Functions 


BASIC.AF 


BASIC  Arithmetic  Functions 


BASIC.FF 


NONE AE . BN 
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BASIC  File  Handling  Functions 
Floatirg  Point  Package 


BATCH. SV 


Batch  System 


PIP.SV  PIP  Program 

A listing  of  the  file  GENCRH.BI  is  as  follows; 


SJOB  GEN CRH 
. R BCOMP 

♦ DSK:IDGEN.EA 
. R PALS 

♦ SYS:  G ETP UT . BN < SYS : PAP CKH . AR/  DSK : GETPl'T.  PA/  F 
.P  PALS 

♦ SY S : TAEL  E. BN<  DSK : SY S DEF. PA/ F 
. P PALS 

♦ SYS:  CVPTBL.  EM<  SYS : PARCEL'.  AF/  DSK:  FTJ CTN  • P.F.*  SYS;  CVPTBL.  AF/ 
.P  PALS 

♦ SYS : CFK . EN < SY  S : PAP.CFH . AH*  TSK : CFH . PA/  F 
.F  AESLDP. 

♦ SY S :NON  EAF..  EN / CRH/  CVPTBL/  TABLE/  GETPt'TS 

. SA  DSK:  INPUT.  SV  0- 7577/  l 0000-  1 7577/  PS000- ?.6Cdr;  ??.?. 

. P PIP 

♦ SYS : TABLE. BN  < / D 
♦DSK: SYSDEF • PA</ D 

♦ SYS: CVPTBL. AP</D 
♦SYS:PARCRH.AP</D 

♦ SYS:  CETPUT.  BN</D 

♦ SYS:  TABLE.  EN</D 

♦ SYS: CFH. BN  < / D 

♦ SYS: CVRTBL. BN< / D 
SEND 


The  program  IDGEN.BA  accepts  as  input  the  files 
DSK.TRNTBL. AR 
DSK:SYSDEF. AR 
DSKrMETHOD. AR 

and  produces  the  temporary  files 
DSK:SYSDEF.PA 
SYStPARCRH.AR 
SYS: CVRTBL. AR 

Additional  temporary  files  are  created  with  the  PAL8  assembler.  These 
temporary  files  are  then  loaded  and  then  saved  to  form  the  program 
INPUT. SV.  All  temporary  files  are  then  deleted. 
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TDS 


The  Data  Handling  System  is  capable  of  computing  the  Total  Dissolved 
Solids  (TDS)  measurement  at  a sample  point  from  the  Total  Solids  (TS)  and 
Suspended  Solids  (SS)  measurements  at  this  point.  If  both  the  TS  and  SS 
measurements  are  present  and  the  TDS  measurement  is  not  present,  then  the 
TDS  measurement  is  computed  and  placed  in  a user  specified  output  file. 

The  TDS  computation  is  normally  requested  by  the  command 

. SUBMIT  TDS 

which  submits  the  BATCH  input  file  TDS.BI  to  the  OS/8  program  BATCH.  This 
command  has  the  data  handling  system  perform  the  following  steps: 

1.  Create  the  files  SYS.'SYSDIR.AR  and  DSKrDSKDIR. AR  with  the 
system  program  DIRECT.  These  files  contain  the  names  of 
all  files  whose  names  begin  with  MASTER. 

2.  Run  the  program  TDSFNA.SV  to  receive  the  name  of  the  master 
input  file  an'  the  output  file  from  the  operator. 

3.  Run  the  program  TDSINF.SV  to  create  an  information  file 
INFO: TDS INF. IN. 

4.  Run  the  program  SORT.SV  to  create  two  sorted  data  files  con- 
taining TS,  SS,  and  TDS. 

5.  Run  the  program  TDS.SV  to  create  an  output  file  which  con- 
tains computed  TDS  measurements. 

This  program  when  loaded  prints  the  names  of  all  master  files  on  the 
devices  DSK:  and  SYS:.  An  example  of  this  print  out  is  as  follows: 

DSK: MASTER  FILES 

DATA  19-OCT-75 

DSK: MASTER. 11 
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SYS: MASTER  FILES 


I 

I 

! 

! 


DATE  19-OCT-75 
SYS: MASTER. 12 

This  program  then  requests  the  operator  to  supply  the  name  of  a master  file 
which  contains  the  most  recent  TS,  SS,  and  TDS  measurements  as  follows: 
MASTER  INPUT  FILE? 

The  operator  would  normally  respond  by  typing  the  last  master  file  which  was 
just  listed. 

The  program  now  asks  the  name  of  the  output  file  from  the  operator  as 
follows : 

OUTPUT  FILE? 

To  have  a file  name  consistant  with  MERGE,  this  file  name  should  have 
the  D1  as  the  first  two  letters.  By  selecting  a file  name  such  as  DITDS 
with  two  character  numeric  extension  would  provide  a unique  file  name  to 
the  system. 
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MAXMIN 


Report  generation  has  been  modified  to  permit  these  reports  to 
include  parameters  such  as  range,  maximum,  minimum,  average,  number 
of  points,  and  standard  deviation  for  selected  measurements.  When 
a report  includes  these  parameters,  report  generation  is  accomplished 
by  the  system  in  7 steps  instead  of  A steps  which  are 

1.  Master  File  Determination 

2.  INFO: INFO. IN  File  Generation 

3.  INF0:MXINF0. IN  File  Generation 

4.  SORT 

5.  MAXMIN  Computations 

6.  SORT 

7.  REPORT 

Steps  3,  *♦,  and  5 are  entered  only  when  these  parameters  are  computed. 
Steps  3 and  create  the  sorted  data  files  DATA:DATA.AA,  DATA: DATA. AB, 
...  etc.  which  are  processed  by  the  OS/8  BASIC  Program  MAXMIN. BA  in 
step  5 to  yield  the  file  DATA: MAXM I N. 01  containing  these  parameters. 

The  OS/8  BASIC  program  MAXMIN. BA  receives  as  input  the  sorted 

data  files  DATA: DATA. AA,  DATA:DATA.AB and  creates  the  data 

file  DATA: MAXM I N. 01 . This  program  expects  the  System  Definition 
File  SYSDEF.AR  to  include  one  or  more  of  the  Day  ID  tags  MAX,  MIN, 

AVE,  RANGE,  STD,  and  NPTS. 

This  program  segments  each  input  file  into  groups  of  measure- 
ments which  have  the  identical  Point,  Period,  Parameter,  and  Discrete 
ID  tags.  The  maximum,  minimum,  average,  range,  standard  deviation, 
and  number  of  points  within  a group  is  then  computed  for  each  group. 


97 


These  computed  parameters  from  all  input  files  are  then  placed  within 
a single  output  file  DATA: MAXM I N. 01 . Any  given  measurement  should 


r- 

i 
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* 
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be  found  in  only  one  input  file.  If  a measurement  is  found  in  two 
or  more  input  files,  the  output  data  file  will  contain  duplicate 
data.  Only  one  output  file  is  created. 

The  input  data  files,  DATA.AA,  DATA.AB,  etc.,  are  created  by 
the  program  SORT  according  to  the  information  file  I NFO: MX  INFO. IN 
prior  to  running  this  program.  The  SORT  program  retrives  selected 
data  from  a specified  master  file  with  the  information  file  providing 
the  instructions  for  this  sorting  operation.  Step  6 creates  new 
data  files,  DATA.AA,  DATA.AB,  etc.,  as  input  to  REPORT. t 

The  report  generation  step  is  normally  requested  by  the  command 
.SUBMIT  REPORT 

which  submits  the  BATCH  input  file  REPORT. Bl  to  the  OS/8  program 
BATCH.  The  devices  DATA,  INFO,  and  OUT  must  be  defined  to  OS/8  prior 
to  starting  the  report  generation  step. 

The  program  DAHDLR  when  loaded  produces  the  following  message 
DATA  HANDLER 
FUNCTION?  REPORT 

for  which  the  operator  must  respond  with  the  command  REPORT  to  specify 
the  report  option.  The  file  INFO: INFO. IN  is  generated  with  the 
function.  The  Day  ID  tag  list  may  contain  the  ID  tags  MAX,  MIN,  AVE, 
NPTS,  STD,  and  RANGE  if  these  parameters  are  desired  in  the  report. 

The  operator  must  specify  either  the  MAXMIN  function  or  the 
MXMN  function  to  generate  the  file  I NFO: MX  I NFO. I N . The  MAXMIN  function 
FUNCTION?  MAXMIN 

has  the  same  commands  as  the  REPORT  function.  The  CONT  data  option 
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with  the  Day  ID  order  being  A is  automatically  selected  with  a segment 
size  of  1000  by  this  function.  The  Day,  Point,  and  Parameter  ID  lists 
should  be  selected  to  specify  the  data  base  to  be  processed  by  the 
program  MAXMIN. BA. 

The  operator  must  specify  the  D0REP0RT  function  in  order  to 
specify  the  master  file  and  to  automatically  execute  steps  A,  5,  6, 
and  7 without  operator  intervention. 

The  REPORT  and  MAXMIN  functions  within  the  program  DAHDLR  are 
independent  of  each  other.  The  REPORT  function  specifies  the  Report 
Format,  Report  Options,  Number  of  Columns,  and  ID  lists  for  the 
final  report.  The  MAXMIN  function  specifies  the  ID  lists  to  be  used 
for  the  MAXMIN  computat ion_ . If  more  than  one  record  is  generated 
by  the  MAXMIN  function,  the  measurements  found  in  each  record  must 
be  different  than  all  other  records.  The  measurements  used  by  the 
REPORT  function  must  agree  with  the  measurements  used  by  the  MAXMIN 
function  to  yield  meaningful  reports. 

The  MXMN  function  automatically  creates  the  information  file 
INF0:MX INFO. IN  directly  from  the  information  file  I NFO: I NFO . I N . 

This  function  requires  the  measurements  printed  for  each  report 
be  different  than  the  measurements  found  in  all  other  reports.  A 
report  is  created  with  the  MXMN  function  by 
FUNCTION?  REPORT 

The  operator  then  creates  the  file  INFO. IN  as  before.  The  operator 
then  responds  with  MXMN  function  before  requesting  D0REP0RT  function. 
FUNCTION?  MXMN 
FUNCTION?  D0REP0RT 
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AUTOMATED  INSTRUMENTATION 


A Fisher  Scientific  Accument  Model  520  Digital  pH/Ion  meter,  a Yellow 
Springs  Model  33  S-C-T  meter,  a Talos  5 1 graphic  tablet,  and  a Digital 
Equipment  Corporation  RT02-BA  data  entry  terminal  were  interfaced  to  the 
data  handling  system  via  a Digital  Equipment  Corporation  PDM-70  program- 
mable data  mover.  Figure  1 is  a block  diagram  of  the  automated  instrumen- 
tation showing  the  inner-connection  of  these  devices.  Each  of  these  devices 
can  operate  in  a stand-alone  mode  independent  of  the  data  handling  system 
or  under  the  control  of  the  data  handling  system.  The  Automated  Instrument 
Users'  Manual  and  the  Automated  Instrument  System  Programmer's  Manual  have 
been  written  to  provide  a detailed  description  of  the  operation  of  this 
system.  The  presentation  which  follows  is  intended  to  provide  an  overview 
of  the  automated  instrumentation. 

The  Talos  digitizer  provides  the  capability  to  the  Army  personnel  of 
automating  the  data  reduction  of  field  strip  chart  recordings.  By  placing 
a strip  chart  on  a 1^  inch  by  11*  inch  active  area  on  the  Talos  digitizer 
surface,  the  user  through  either  a four  button  cursor  or  a stylus  may 
determine  x-y  coordinates  of  any  point  on  this  graph  to  an  accuracy  of 
.01  inches.  The  x-y  coordinates  of  this  point  are  displayed  on  a front 
panel  display  and  can  be  transferred  to  the  data  handling  system  via  the 
PDM-70  by  pressing  a cursor  button  or  touching  the  point  with  the  stylus. 

Some  status  information  such  as  the  cursor  push  button  js  also  interfaced 
to  the  PDM-70.  The  data  handling  system  can  then  be  programmed  with  the 
appropriate  data  reduction  algorithm  to  arrive  at  the  result.  The  interface 

I 

between  the  Talos  digitizer  and  the  PDM-70  was  fabricated  at  Clemson  University. 

The  Fisher  Scientific  pH/Ion  meter  provides  a 5 digit  display  on  the 
fron  panel  of  the  meter  and  is  interfaced  to  the  PDM-70. 

I 
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The  interface  between  the  PDM-70  and  the  pH  meter  was  implemented  at 
Clemson  University  and  contains  a button  with  a light  for  data  transfer. 

The  measurement  value  being  displayed  on  the  front  panel  display  along 
with  the  front  panel  switch  settings  and  over  range  indicator  is  transferred 
to  the  PDM-70  by  pressing  the  lighted  button  on  the  PDM-70  interfaced. 

The  Yellow  Springs  S-C-T  meter  was  slightly  modified  to  permit  the 
meter  to  give  two  analog  outputs.  One  output  is  proportional  to  the  S-C-T 
meter  reading  while  the  other  output  is  coded  to  give  the  front  panel 
switch  settings.  These  analog  outputs  are  interfaced  to  the  PDM-70  with  a 
meter  reading  being  transferred  whenever  a lighted  button  associated  with 
the  PDM-70/S-C-T  interface  is  pressed  by  the  user.  This  interface  was 
fabricated  at  Clemson  University. 

Each  measurement  handled  by  the  data  handling  system  must  have  an 
ID  and  a measurement  value.  The  DEC  RT-02-BA  provides  the  user  of  the 
automated  instrumentation  the  ability  to  enter  the  ID  information  via  the 
keyboard  for  each  of  the  samples  whose  value  is  being  measured  by  either 
the  interfaced  pH  and  specific  conductivity  instrumentation.  The  DEC 
RT-02-BA  also  has  a 32  character  alphanumeric  display  and  provides  the 
user  with  messages  from  the  data  handling  system. 

The  PDM-70  programmable  data  mover  provides  a communications  link  and 
formatting  facilities  for  concentrating  and  transferring  data  between  a 
selected  source  and  destination.  The  data  may  be  in  an  analog,  parallel 
BCD  or  binary,  and  format.  The  PDM-70  can  be  operated  as  a stand-alone 
unit  or  under  the  control  of  a host  computer.  Integration  into  a computer- 
based  system  is  easily  accomplished  through  a standard  asychronous  serial 
interface  on  the  computer. 
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The  PDM-70  system  accommodes  both  source  and  destination  modules.  Any 
source  module  under  the  control  of  the  PDM-70  can  communicate  with  any  or 
all  destination  modules.  Source  modules  present  in  the  system  are  as 
f o 1 1 ows : 


2 

1 

1 

2 


PDM70-D  Eight  digit  BCD  input 
PDM70-F  Four  channel  analog  input 
PDM70-JR  Serial  I/O  module 
PDM70-J  Serial  I/O  module 


The  destination  modules  present  in  the  system  are  as  follows: 


1 PDP70-E  Eight  digit  BCD  output 

1 PDP70-H  Two  '■hannel  analog  output 

2 PDM70-J  Serial  I/O  module 

1 PDM70-JR  Serial  I/O  module 


Communication  or  information  transfer  from  a selected  source  to  the 
selected  destination  modules  is  controlled  by  the  stored  program  being 
executed  by  the  PDM-70.  This  program  is  normally  entered  via  a PDM70-JR 
serial  I/O  module  with  a connected  teletype  or  remote  computer.  The 
programming  commands  are  a sequence  of  ASCII  characters. 

A user  function  for  OS/8  BASIC  has  been  provided  to  allow  any  BASIC 
program  to  remotely  program  the  PDM-70  and  to  transfer  data  between  the 
BASIC  program  and  the  PDM-70.  In  addition,  the  data  entry  software  for  the 
data  handling  system  supports  the  automated  i ns t rumen ta t i on , 

The  OS/8  BASIC  program  WTHDL.BA  is  provided  for  handling  the  Talos 
digitizer  data.  This  program  receives  x-y  coorindate  information  from  the 
digitizer  on-line,  converts  these  coordinates  from  the  digitizer  units  to 
the  units  of  the  strip  chart  recording,  and  places  these  converted  coordinates 


in  a file. 
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The  program  provides  the  user  with  the  capability  to  edit  the  data  received 


from  the 
program. 


d i g i t i zer  and  the 
These  data  files 


data  within  the  data  files  created  by  this 
can  be  accessed  by  any  OS/8  BASIC  program. 


